Pemecahan masalah error runtime kebijakan JSON ke XML

Anda sedang melihat dokumentasi Apigee dan Apigee Hybrid.
Lihat dokumentasi Apigee Edge.

SourceUnavailable

Kode error

steps.json2xml.SourceUnavailable

Isi respons error

{
    "fault": {
        "faultstring": "JSONToXML[policy_name]: Source [source_variable] is not available",
        "detail": {
            "errorcode": "steps.json2xml.SourceUnavailable"
        }
    }
}

Contoh error

{
    "fault": {
        "faultstring": "JSONToXML[Convert-JSONToXML]: Source response is not available",
        "detail": {
            "errorcode": "steps.json2xml.SourceUnavailable"
        }
    }
}

Penyebab

Error ini terjadi jika variabel message yang ditentukan dalam elemen <Source> dari kebijakan JSON ke XML adalah:

Di luar cakupan (tidak tersedia dalam alur tertentu tempat kebijakan dijalankan) atau
Tidak dapat diselesaikan (tidak ditentukan)

Misalnya, error ini terjadi jika kebijakan JSON ke XML seharusnya dijalankan dalam alur permintaan, tetapi elemen <Source> ditetapkan ke variabel response, yang tidak ada dalam alur permintaan.

Diagnosis

Identifikasi kebijakan JSON ke XML tempat terjadinya error dan nama variabel yang tidak tersedia. Anda dapat menemukan kedua item ini di elemen faultstring dalam respons error. Misalnya, dalam faultstring berikut, nama kebijakan adalah Convert-JSONToXML dan variabelnya adalah response:
```
"faultstring": "JSONToXML[Convert-JSONToXML]: Source response is not available"
```

Dalam XML kebijakan JSON ke XML yang gagal, pastikan nama set variabel dalam elemen <Source> cocok dengan nama variabel yang diidentifikasi dalam string kesalahan (langkah #1 di atas). Misalnya, kebijakan JSON ke XML berikut menentukan variabel bernama response dalam elemen <Source>, yang cocok dengan yang ada di faultstring:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JSONToXML async="false" continueOnError="false" enabled="true" name="Convert-JSONToXML">
    <DisplayName>Convert-JSONToXML</DisplayName>
    <Properties/>
    <Options>
        <NullValue>NULL</NullValue>
        <NamespaceBlockName>#namespaces</NamespaceBlockName>
    <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
        <NamespaceSeparator>:</NamespaceSeparator>
        <TextNodeName>#text</TextNodeName>
        <AttributeBlockName>#attrs</AttributeBlockName>
        <AttributePrefix>@</AttributePrefix>
        <InvalidCharsReplacement>_</InvalidCharsReplacement>
        <ObjectRootElementName>Root</ObjectRootElementName>
        <ArrayRootElementName>Array</ArrayRootElementName>
        <ArrayItemElementName>Item</ArrayItemElementName>
    </Options>
    <OutputVariable>request</OutputVariable>
    <Source>response</Source>
</JSONToXML>

Tentukan apakah variabel yang digunakan dalam elemen <Source> ditentukan dan tersedia dalam alur tempat kebijakan JSON ke XML sedang dieksekusi.
Jika variabelnya adalah:
- Di luar cakupan (tidak tersedia dalam alur tertentu tempat kebijakan dijalankan) atau
- Tidak dapat diselesaikan (tidak ditentukan)
maka itulah penyebab error.

Sebagai contoh, misalkan kebijakan JSON ke XML yang ditampilkan di atas seharusnya dieksekusi dalam alur request. Ingat bahwa variabel response digunakan dalam elemen <Source> dari kebijakan JSON ke XML. Variabel respons hanya tersedia di alur respons.

Karena variabel response tidak ada dalam alur permintaan, Anda akan menerima kode error:
```
steps.json2xml.SourceUnavailable
```

Resolusi

Pastikan variabel yang ditetapkan dalam elemen <Source> dari kebijakan JSON ke XML yang gagal ditentukan dan ada dalam alur tempat kebijakan dijalankan.

Untuk memperbaiki contoh kebijakan JSON ke XML yang ditunjukkan di atas, Anda dapat mengubah elemen <Source> untuk menggunakan variabel request, karena variabel tersebut ada dalam alur permintaan:

  <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <JSONToXML async="false" continueOnError="false" enabled="true" name="Convert-JSONToXML">
      <DisplayName>Convert-JSONToXML</DisplayName>
      <Properties/>
      <Options>
          <NullValue>NULL</NullValue>
          <NamespaceBlockName>#namespaces</NamespaceBlockName>
          <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
          <NamespaceSeparator>:</NamespaceSeparator>
          <TextNodeName>#text</TextNodeName>
          <AttributeBlockName>#attrs</AttributeBlockName>
          <AttributePrefix>@</AttributePrefix>
          <InvalidCharsReplacement>_</InvalidCharsReplacement>
          <ObjectRootElementName>Root</ObjectRootElementName>
          <ArrayRootElementName>Array</ArrayRootElementName>
          <ArrayItemElementName>Item</ArrayItemElementName>
      </Options>
      <OutputVariable>request</OutputVariable>
      <Source>request</Source>
  </JSONToXML>

ExecutionFailed

Kode error

steps.json2xml.ExecutionFailed

Isi respons error

{
   "fault": {
        "faultstring": "JSONToXML[policy_name]: Execution failed due to reason: Expecting { or [ at line 1",
        "detail": {
            "errorcode": "steps.json2xml.ExecutionFailed"
        }
    }
}

Kemungkinan penyebab

Kemungkinan penyebab error ini adalah:

Penyebab	Deskripsi
Payload input tidak ada	Payload input (JSON) kosong.
Input Tidak Valid atau Salah Format	Input (JSON) yang diteruskan ke kebijakan JSON ke XML tidak valid atau salah format.

Penyebab: Payload input tidak ada

Dalam kebijakan JSON ke XML, jika konten (payload) variabel yang ditentukan dalam elemen <Source> kosong, maka error ini akan terjadi.

Misalnya, jika elemen <Source> dalam kebijakan JSON ke XML ditetapkan sebagai variabel request atau response dan seharusnya berisi payload JSON, tetapi jika payload kosong, maka error akan terjadi.

Diagnosis

Identifikasi kebijakan JSON ke XML tempat terjadinya error. Anda dapat menemukan informasi ini di elemen faultstring dari respons error. Misalnya, dalam faultstring berikut, nama kebijakan adalah Convert-JSONToXML:
```
"faultstring": "JSONToXML[Convert-JSONToXML]: Execution failed due to reason: Expecting { or [ at line 1"
```

Periksa elemen <Source> dalam XML kebijakan JSON ke XML yang gagal dan tentukan variabel yang ditentukan. Misalnya, kebijakan JSON ke XML berikut memiliki elemen <Source> yang ditetapkan ke request:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JSONToXML async="false" continueOnError="false" enabled="true" name="Convert-JSONToXML">
<DisplayName>Convert-JSONToXML</DisplayName>
<Properties/>
<Options>
    <NullValue>NULL</NullValue>
    <NamespaceBlockName>#namespaces</NamespaceBlockName>
    <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
    <NamespaceSeparator>:</NamespaceSeparator>
    <TextNodeName>#text</TextNodeName>
    <AttributeBlockName>#attrs</AttributeBlockName>
    <AttributePrefix>@</AttributePrefix>
    <InvalidCharsReplacement>_</InvalidCharsReplacement>
    <ObjectRootElementName>Root</ObjectRootElementName>
    <ArrayRootElementName>Array</ArrayRootElementName>
    <ArrayItemElementName>Item</ArrayItemElementName>
</Options>
<OutputVariable>request</OutputVariable>
<Source>request</Source>
</JSONToXML>

Periksa apakah variabel yang ditentukan untuk elemen <Source> dalam kebijakan kosong. Jika kosong, maka itulah penyebab error.

Dalam contoh kebijakan JSON ke XML yang ditunjukkan di atas, payload permintaan (yaitu, isi permintaan) yang dikirim oleh klien kosong.

Contoh:
```
curl -v "http://your_host_alias/v1/testjsontoxml" -H "Content-Type: application/json"
```
Dengan your_host_alias adalah domain yang menghadap publik yang digunakan untuk mengakses API Anda, seperti yang dikonfigurasi dalam properti virtualhosts.hostAliases di file penggantian Anda. Lihat Menentukan penggantian konfigurasi.

Karena payload respons JSON kosong, Anda akan menerima kode error:
```
steps.json2xml.ExecutionFailed
```
Error ini juga dapat terjadi jika elemen <Source> disetel ke respons, tetapi payload kosong diteruskan oleh server backend.

Catatan: Header Jenis Konten HTTP dari pesan sumber harus ditetapkan ke application/json; jika tidak, kebijakan akan dilewati selama pemrosesan dan oleh karena itu tidak diterapkan.

Resolusi

Pastikan input yang diteruskan ke kebijakan JSON ke XML dalam elemen <Source> adalah payload JSON yang valid dan tidak kosong.

Untuk memperbaiki masalah pada kebijakan JSON ke XML contoh, teruskan payload JSON yang valid. Contoh:

Buat file bernama city.json dengan konten berikut:

{
  "Name":"Apigee",
  "City":"Bengaluru",
  "Pincode":"560016"
}

Lakukan panggilan API menggunakan perintah curl sebagai berikut:
```
curl -v "http://your_host_alias/v1/testxmltojson" -H "Content-Type: application/json" -X POST -d @company.json
```
Dengan your_host_alias adalah domain yang menghadap publik yang digunakan untuk mengakses API Anda, seperti yang dikonfigurasi dalam properti virtualhosts.hostAliases di file penggantian Anda. Lihat Menentukan penggantian konfigurasi.

Penyebab: Input Tidak Valid atau Salah Format

Jika kebijakan JSON ke XML mengurai input yang tidak valid atau salah bentuk, Anda akan mendapatkan error ini.

Misalnya, jika JSON tidak valid berikut diberikan sebagai input ke kebijakan JSON ke XML,

[
    "args": ["name" : "Google" ]
]

Anda akan mendapatkan error:

"faultstring": "JSONToXML[Convert-JSONToXML]: Execution failed due to reason: Expecting { or [ at line 1"

Diagnosis

Identifikasi kebijakan JSON ke XML tempat terjadinya error. Anda dapat menemukan informasi ini di elemen faultstring dari respons error. Misalnya, dalam faultstring berikut, nama kebijakan adalah Convert-JSONToXML:
```
"faultstring": "JSONToXML[Convert-JSONToXML]: Execution failed due to reason: Expecting { or [ at line 1"
```

Periksa elemen <Source> yang ditentukan dalam XML kebijakan JSON ke XML yang gagal. Misalnya, kebijakan JSON ke XML berikut memiliki elemen <Source> yang ditetapkan ke variabel request:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JSONToXML async="false" continueOnError="false" enabled="true" name="Convert-JSONToXML">
  <DisplayName>Convert-JSONToXML</DisplayName>
  <Properties/>
  <Options>
      <NullValue>NULL</NullValue>
      <NamespaceBlockName>#namespaces</NamespaceBlockName>
      <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
      <NamespaceSeparator>:</NamespaceSeparator>
      <TextNodeName>#text</TextNodeName>
      <AttributeBlockName>#attrs</AttributeBlockName>
      <AttributePrefix>@</AttributePrefix>
      <InvalidCharsReplacement>_</InvalidCharsReplacement>
      <ObjectRootElementName>Root</ObjectRootElementName>
      <ArrayRootElementName>Array</ArrayRootElementName>
      <ArrayItemElementName>Item</ArrayItemElementName>
  </Options>
  <OutputVariable>request</OutputVariable>
  <Source>request</Source>
</JSONToXML>

Validasi apakah input yang ditentukan dalam elemen <Source> adalah payload JSON yang valid. Jika input tidak valid atau salah format, maka itulah penyebab error.

Asumsikan bahwa JSON tidak valid berikut diteruskan ke kebijakan
```
[
    "args": ["name" : "Google" ]
]
```
Berikut adalah contoh panggilan API yang menunjukkan cara permintaan diteruskan:
```
curl -v "http://your_host_alias/v1/testjsontoxml" -H "Content-Type:
application/json" -X POST -d '[ "args" : ["name" : "Google" ]]'
```
Dengan your_host_alias adalah domain yang menghadap publik yang digunakan untuk mengakses API Anda, seperti yang dikonfigurasi dalam properti virtualhosts.hostAliases di file penggantian Anda. Lihat Menentukan penggantian konfigurasi.

Payload JSON yang diteruskan dalam permintaan tidak valid karena objek JSON dimulai dan diakhiri dengan tanda kurung siku ([ ]). Oleh karena itu, Anda menerima kode error:

steps.json2xml.ExecutionFailed

Catatan: Payload JSON dapat berisi objek JSON dan/atau array JSON. Objek JSON yang valid dimulai dengan { dan diakhiri dengan }. Array JSON yang valid (di tingkat terluar), yang dimulai dengan [ dan diakhiri dengan ].

Error ini juga dapat terjadi jika elemen <Source> disetel ke respons, tetapi payload respons JSON tidak valid atau salah format.

Catatan: Header Content-type HTTP dari pesan sumber harus ditetapkan ke application/json, jika tidak, kebijakan tidak akan diterapkan, yang berarti kebijakan akan dilewati selama pemrosesan.

Resolusi

Pastikan input yang diteruskan ke kebijakan JSON ke XML dalam elemen <Source> valid dan tidak salah bentuk.

Untuk memperbaiki masalah pada kebijakan JSON ke XML sampel yang dibahas di atas, teruskan permintaan payload JSON yang valid sebagai berikut:

{
  "args"  : {

        "name"  :  "Google"
   }
}

OutputVariableIsNotAvailable

Kode error

steps.json2xml.OutputVariableIsNotAvailable

Isi respons error

{
    "fault": {
        "faultstring": "JSONToXML[policy_name]: Output variable is not available.",
        "detail": {
            "errorcode": "steps.json2xml.OutputVariableIsNotAvailable"
        }
    }
}

Contoh error

{
    "fault": {
        "faultstring": "JSONToXML[Check-JSONToXML]: Output variable is not available.",
        "detail": {
            "errorcode": "steps.json2xml.OutputVariableIsNotAvailable"
        }
    }
}

Penyebab

Error ini terjadi jika variabel yang ditentukan dalam elemen <Source> dari Kebijakan JSON ke XML berjenis string dan elemen <OutputVariable> tidak ditentukan. Elemen <OutputVariable> wajib ada jika variabel yang ditentukan dalam elemen <Source> berjenis string.

Diagnosis

Identifikasi Kebijakan JSON ke XML tempat terjadinya error. Anda dapat menemukannya di elemen faultstring dalam respons error. Misalnya, dalam faultstring berikut, nama kebijakan adalah Check-JSONToXML:
```
"faultstring": "JSONToXML[Check-JSONToXML]: Output variable is not available."
```

Dalam kebijakan JSON ke XML yang gagal, validasi apakah <OutputVariable> tidak ada.

Kebijakan JSONToXML contoh berikut tidak memiliki elemen <OutputVariable>:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JSONToXML async="false" continueOnError="false" enabled="true" name="JSONToXML">
    <DisplayName>Check-JSONToXML</DisplayName>
    <Properties/>
    <Options>
        <NullValue>NULL</NullValue>
        <NamespaceBlockName>#namespaces</NamespaceBlockName>
        <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
        <NamespaceSeparator>:</NamespaceSeparator>
        <TextNodeName>#text</TextNodeName>
        <AttributeBlockName>#attrs</AttributeBlockName>
        <AttributePrefix>@</AttributePrefix>
        <InvalidCharsReplacement>_</InvalidCharsReplacement>
        <ObjectRootElementName>Root</ObjectRootElementName>
        <ArrayRootElementName>Array</ArrayRootElementName>
        <ArrayItemElementName>Item</ArrayItemElementName>
    </Options>
    <Source>PostalCode</Source>
</JSONToXML>

Tentukan jenis variabel yang ditentukan dalam elemen <Source>:
1. Cari kode dalam Proxy API tempat variabel ditentukan terlebih dahulu.
2. Setelah mengetahui kebijakan tempat variabel ditentukan dan diisi terlebih dahulu, Anda perlu menentukan jenis variabel tersebut sebagai berikut:
  1. Periksa nilai atribut jenis (jika ada).
  2. Jika atribut jenis tidak ada, variabel dianggap sebagai string.
3. Jika jenis variabel adalah string, maka itulah penyebab error. Anda dapat mempelajari variabel umum dan jenisnya di Referensi variabel.
Misalnya, lihat variabel PostalCode dalam kebijakan JSON ke XML di atas.

Sebagai contoh, pertimbangkan bahwa kebijakan Tetapkan Pesan digunakan untuk menetapkan nilai ke variabel yang disebut PostalCode seperti yang ditunjukkan di bawah ini:
```
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Assign_PostalCode">
    <DisplayName>Assign_PostalCode</DisplayName>
    <Properties/>
    <AssignVariable>
        <Name>PostalCode</Name>
        <Value>{"value":"56008"}</Value>
        <Ref/>
    </AssignVariable>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
    <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>
```
Perhatikan bahwa jenis variabel yang ditetapkan di <AssignVariable> adalah string. Jadi, variabel PostalCode adalah jenis string.

Sekarang, ingatlah bahwa variabel PostalCode digunakan dalam elemen <Source> pada kebijakan JSONToXML:
```
<Source>PostalCode</Source>
```
Karena PostalCode berjenis string dan elemen <OutputVariable> tidak ada, Anda akan menerima kode error:
```
steps.json2xml.OutputVariableIsNotAvailable
```

Resolusi

Pastikan bahwa jika variabel yang ditentukan dalam elemen <Source> dari Kebijakan JSONToXML berjenis string, elemen <OutputVariable> ditentukan dalam kebijakan.

Untuk memperbaiki Kebijakan JSONToXML yang dibahas di atas, sertakan elemen <OutputVariable> seperti yang ditunjukkan di bawah.

  <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <JSONToXML async="false" continueOnError="false" enabled="true" name="JSONToXML">
      <DisplayName>Check-JSONToXML</DisplayName>
      <Properties/>
      <Options>
          <NullValue>NULL</NullValue>
          <NamespaceBlockName>#namespaces</NamespaceBlockName>
          <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
          <NamespaceSeparator>:</NamespaceSeparator>
          <TextNodeName>#text</TextNodeName>
          <AttributeBlockName>#attrs</AttributeBlockName>
          <AttributePrefix>@</AttributePrefix>
          <InvalidCharsReplacement>_</InvalidCharsReplacement>
          <ObjectRootElementName>Root</ObjectRootElementName>
          <ArrayRootElementName>Array</ArrayRootElementName>
          <ArrayItemElementName>Item</ArrayItemElementName>
      </Options>
      <OutputVariable>response</OutputVariable>
      <Source>PostalCode</Source>
  </JSONToXML>

InCompatibleTypes

Kode error

steps.json2xml.InCompatibleTypes

Isi respons error

{
    "fault": {
        "faultstring": "JSONToXML[policy_name]: String can not be assigned to message type.",
        "detail": {
            "errorcode": "steps.json2xml.InCompatibleTypes"
        }
    }
}

Contoh error

{
    "fault": {
        "faultstring": "JSONToXML[JSONToXML_checktype]: String can not be assigned to message type.",
        "detail": {
            "errorcode": "steps.json2xml.InCompatibleTypes"
        }
    }
}

Penyebab

Error ini terjadi jika jenis variabel yang ditentukan dalam elemen <Source> dan elemen <OutputVariable> tidak sama. Jenis variabel yang ada dalam elemen <Source> dan elemen <OutputVariable> harus sama.

Jenis yang valid adalah message dan string.

Diagnosis

Identifikasi Kebijakan JSON ke XML tempat terjadinya error. Anda dapat menemukannya di elemen faultstring dalam respons error. Misalnya, dalam faultstring berikut, nama kebijakan adalah JSONToXML_checktype:
```
"faultstring": "JSONToXML[JSONToXML_checktype]: String can not be assigned to message type."
```

Dalam kebijakan JSON ke XML yang gagal, perhatikan nilai yang ditentukan dalam <OutputVariable> dan <Source>.

Perhatikan contoh kebijakan berikut:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JSONToXML async="false" continueOnError="false" enabled="true" name="JSONToXML_checktype">
    <DisplayName>JSONToXML_checktype</DisplayName>
    <Properties/>
    <Options>
        <NullValue>NULL</NullValue>
        <NamespaceBlockName>#namespaces</NamespaceBlockName>
        <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
        <NamespaceSeparator>:</NamespaceSeparator>
        <TextNodeName>#text</TextNodeName>
        <AttributeBlockName>#attrs</AttributeBlockName>
        <AttributePrefix>@</AttributePrefix>
        <InvalidCharsReplacement>_</InvalidCharsReplacement>
        <ObjectRootElementName>Root</ObjectRootElementName>
        <ArrayRootElementName>Array</ArrayRootElementName>
        <ArrayItemElementName>Item</ArrayItemElementName>
    </Options>
    <OutputVariable>response</OutputVariable>
    <Source>PostalCode</Source>
</JSONToXML>

Tentukan jenis variabel yang ditentukan dalam elemen <Source> dan <OutputVariable>:
1. Cari kode dalam Proxy API tempat setiap variabel ini ditentukan terlebih dahulu.
2. Setelah mengetahui kebijakan tempat variabel ditentukan dan diisi terlebih dahulu, Anda perlu menentukan jenis variabel tersebut sebagai berikut:
  1. Periksa nilai atribut jenis (jika ada).
  2. Jika atribut jenis tidak ada, variabel dianggap sebagai string.
3. Jika jenis variabel yang ditentukan dalam <Source> adalah string, sedangkan jenis <OutputVariable> adalah pesan atau sebaliknya, maka itulah penyebab error. Anda dapat mempelajari variabel umum dan jenisnya di Referensi variabel.
Sebagai contoh, pertimbangkan kebijakan Tetapkan Pesan yang digunakan untuk menetapkan nilai ke variabel yang disebut PostalCode seperti yang ditunjukkan di bawah ini:
```
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Assign_PostalCode">
    <DisplayName>Assign_PostalCode</DisplayName>
    <Properties/>
    <AssignVariable>
        <Name>PostalCode</Name>
        <Value>{"value":"56008"}</Value>
        <Ref/>
    </AssignVariable>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
    <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>
```
Perhatikan bahwa jenis variabel yang ditetapkan di <AssignVariable> adalah string; oleh karena itu, variabel PostalCode adalah jenis string.

Sekarang, ingatlah bahwa variabel PostalCode digunakan dalam elemen <Source> pada kebijakan JSONToXML:
```
<Source>PostalCode</Source>
```
Demikian pula, ingat bahwa variabel response digunakan dalam elemen <OutputVariable> kebijakan JSONToXML:
```
<OutputVariable>response</OutputVariable>
```
Karena PostalCode adalah jenis string, sedangkan variabel response adalah jenis pesan, keduanya adalah jenis yang tidak kompatibel sehingga Anda menerima kode error:
```
steps.json2xml.InCompatibleTypes
```
Error di atas juga dapat terjadi jika variabel dalam elemen <Source> berjenis message, tetapi variabel dalam elemen <OutputVariable> berjenis string.

Resolusi

Pastikan jenis variabel yang ditentukan dalam elemen <Source> dan elemen <OutputVariable> selalu sama. Jenis variabel yang ada dalam elemen <Source> dan elemen <OutputVariable> harus sama. Artinya, pastikan jenis elemen <Source> dan <OutputVariable> adalah jenis string atau pesan.

Untuk memperbaiki Kebijakan JSON ke XML yang dibahas di atas, Anda dapat mendeklarasikan variabel PostalCode_output lain berjenis string menggunakan Kebijakan Tetapkan Pesan, dan menggunakan variabel ini dalam elemen <OutputVariable> dari Kebijakan JSON ke XML.

Kebijakan Assign Message yang diubah:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<AssignMessage async="false" continueOnError="false" enabled="true" name="Assign_PostalCode">
    <DisplayName>Assign_PostalCode</DisplayName>
    <Properties/>
    <AssignVariable>
        <Name>PostalCode</Name>
        <Value>{"value":"56008"}</Value>
        <Ref/>
    </AssignVariable>
    <AssignVariable>
        <Name>PostalCode_output</Name>
        <Ref/>
    </AssignVariable>
    <IgnoreUnresolvedVariables>true</IgnoreUnresolvedVariables>
    <AssignTo createNew="false" transport="http" type="request"/>
</AssignMessage>

Kebijakan JSONToXML yang diubah:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JSONToXML async="false" continueOnError="false" enabled="true" name="JSONToXML">
    <DisplayName>JSONToXML_checktype</DisplayName>
    <Properties/>
    <Options>
        <NullValue>NULL</NullValue>
        <NamespaceBlockName>#namespaces</NamespaceBlockName>
        <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
        <NamespaceSeparator>:</NamespaceSeparator>
        <TextNodeName>#text</TextNodeName>
        <AttributeBlockName>#attrs</AttributeBlockName>
        <AttributePrefix>@</AttributePrefix>
        <InvalidCharsReplacement>_</InvalidCharsReplacement>
        <ObjectRootElementName>Root</ObjectRootElementName>
        <ArrayRootElementName>Array</ArrayRootElementName>
        <ArrayItemElementName>Item</ArrayItemElementName>
    </Options>
    <OutputVariable>PostalCode_output</OutputVariable>
    <Source>PostalCode</Source>
</JSONToXML>

InvalidSourceType

Kode error

steps.json2xml.InvalidSourceType

Isi respons error

{
    "fault": {
        "faultstring": "JSONToXML[class invalid_class]: Invalid source type class invalid_class. Valid source types are [message, string].",
        "detail": {
            "errorcode": "steps.json2xml.InvalidSourceType"
        }
    }
}

Contoh error

{
    "fault": {
        "faultstring": "JSONToXML[class java.lang.Integer]: Invalid source type class java.lang.Integer. Valid source types are [message, string].",
        "detail": {
            "errorcode": "steps.json2xml.InvalidSourceType"
        }
    }
}

Penyebab

Error ini terjadi jika jenis variabel yang digunakan untuk menentukan elemen <Source> tidak valid.Jenis variabel yang valid adalah message dan string.

Diagnosis

Identifikasi jenis sumber yang tidak valid yang digunakan dalam kebijakan JSON ke XML. Anda dapat menemukan informasi ini dalam pesan error. Misalnya, pada error berikut, jenis yang tidak valid adalah Integer.
```
"faultstring": "JSONToXML[class java.lang.Integer]: Invalid source type class java.lang.Integer. Valid source types are [message, string]."
```
Periksa semua kebijakan JSON ke XML di Proxy API tertentu tempat kegagalan terjadi. Dalam Kebijakan JSON ke XML yang gagal, catat nama variabel yang ditentukan dalam <Source>.

Berikut adalah contoh kebijakan yang memiliki variabel bernama EmployeeID yang ditentukan dalam elemen <Source>:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JSONToXML async="false" continueOnError="false" enabled="true" name="JSONToXML">
    <DisplayName>Check_SourceType</DisplayName>
    <Properties/>
    <Options>
        <NullValue>NULL</NullValue>
        <NamespaceBlockName>#namespaces</NamespaceBlockName>
        <DefaultNamespaceNodeName>$default</DefaultNamespaceNodeName>
        <NamespaceSeparator>:</NamespaceSeparator>
        <TextNodeName>#text</TextNodeName>
        <AttributeBlockName>#attrs</AttributeBlockName>
        <AttributePrefix>@</AttributePrefix>
        <InvalidCharsReplacement>_</InvalidCharsReplacement>
        <ObjectRootElementName>Root</ObjectRootElementName>
        <ArrayRootElementName>Array</ArrayRootElementName>
        <ArrayItemElementName>Item</ArrayItemElementName>
    </Options>
    <OutputVariable>request</OutputVariable>
    <Source>EmployeeID</Source>
</JSONToXML>

Tentukan jenis variabel yang ditentukan dalam elemen <Source>:
1. Cari kode dalam Proxy API tempat variabel ini ditentukan terlebih dahulu.
2. Setelah mengetahui kebijakan tempat variabel ditentukan dan diisi terlebih dahulu, Anda perlu menentukan jenis variabel tersebut sebagai berikut:
  1. Periksa nilai atribut jenis (jika ada).
  2. Jika atribut jenis tidak ada, variabel dianggap sebagai string.
3. Jika jenis variabel yang ditentukan dalam <Source> bukan jenis pesan atau string, maka itulah penyebab errornya. Anda dapat mempelajari variabel umum dan jenisnya di Referensi variabel.
Sebagai contoh, mari kita pertimbangkan bahwa kebijakan ExtractVariables digunakan untuk mengekstrak nilai dari payload JSON dan menetapkan nilai ke variabel EmployeeID berjenis integer seperti yang ditunjukkan di bawah ini:
```
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ExtractVariables name="ExtractJSONVariables">
    <Source>request</Source>
    <JSONPayload>
        <Variable name="EmployeeID" type="integer">
            <JSONPath>$.ID</JSONPath>
        </Variable>
    </JSONPayload>
</ExtractVariables>
```
Sekarang, ingatlah bahwa variabel EmployeeID digunakan dalam elemen <Source> pada kebijakan JSONToXML:
```
<Source>EmployeeID</Source>
```
Karena jenis variabel ini adalah Integer, yang bukan jenis <Source> yang valid, Proxy API gagal dengan error:
```
steps.json2xml.InvalidSourceType
```

Resolusi

Pastikan jenis variabel yang digunakan untuk menentukan elemen <Source> valid. Jenis <Source> yang valid adalah message dan string.

Untuk menghindari error di atas dengan kebijakan JSONToXML, Anda dapat menggunakan variabel permintaan yang berjenis pesan atau string lain yang merupakan payload JSON yang valid.

Pemecahan masalah error runtime kebijakan JSON ke XML Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

SourceUnavailable

Kode error

Isi respons error

Contoh error

Penyebab

Diagnosis

Resolusi

ExecutionFailed

Kode error

Isi respons error

Kemungkinan penyebab

Penyebab: Payload input tidak ada

Diagnosis

Resolusi

Penyebab: Input Tidak Valid atau Salah Format

Diagnosis

Resolusi

OutputVariableIsNotAvailable

Kode error

Isi respons error

Contoh error

Penyebab

Diagnosis

Resolusi

InCompatibleTypes

Kode error

Isi respons error

Contoh error

Penyebab

Diagnosis

Resolusi

InvalidSourceType

Kode error

Isi respons error

Contoh error

Penyebab

Diagnosis

Resolusi

Pemecahan masalah error runtime kebijakan JSON ke XML