Hyödyllinen virheraportti tarvitsee epäonnistuvan rakenteen, ei oikeita asiakastietoja. Älä liitä tuotantodataa julkiseen ilmoitukseen ja peitä vasta sitten ilmeisiä nimiä. Sisäkkäiset kentät, tunnisteet, URL:t ja vapaa teksti voivat edelleen tunnistaa henkilön.
Kirjoita uusi keksitty esimerkki, joka toistaa syntaksivirheen. Loppupilkun tapauksessa {"demo":[1,2,]} riittää. Siinä on ominaisuus, taulukko ja virheellinen pilkku ilman alkuperäistä tietuetta. Jos ongelma on muu, säilytä pienin tarpeellinen sisäkkäisyys tai escape-rakenne ja keksi kaikki arvot. Tämä on käsin tehtävä valmistelu; kumpikaan työkalu ei anonymisoi automaattisesti.
Lopullinen raportti voi olla lyhyt:
- Työkalun URL ja tila.
- Epäonnistuva synteettinen syöte.
- Havaittu virhe tarkasti kopioituna.
- Ehdotettu synteettinen tulos ja pieni ero.
- Jäsentyykö ehdotettu tulos muotoilijassa.
- Mitä ei testattu, kuten vastaanottavan sovelluksen skeema.
Jos ongelmaa ei voi toistaa ilman aitoa dataa, lopeta ennen julkaisua. Pyydä hyväksytty yksityinen ilmoituskanava äläkä oleta paikallisen käsittelyn tekevän myöhemmistä kuvakaappauksista tai ilmoituksista yksityisiä. Tyhjennä näyte lopuksi ja tarkista kuvakaappauksista muut välilehdet ja tilitiedot.
Esimerkin nopea vertailu
| Vaihe | Mitä kirjoitat tai näet |
|---|---|
| Virheellinen syöte | {"demo":[1,2,]}Viimeinen pilkku ennen ]-merkkiä on virheellinen. |
| Suorituksen tulos | Valitse Tila: Muotoile → Suorita. Testattu versio näyttää ”Tarkista syöte ja valittu muoto.” Tuloste jää tyhjäksi; Kopioi tulos ei ole käytettävissä. Virheteksti voi vaihdella. |
| Korjattu syöte | {"demo":[1,2]}Suorita uudelleen. Tuloste sisältää demo-ominaisuuden ja taulukon [1, 2]; sisennys voi muuttua, arvot eivät. |
Toista esimerkki oikeassa muotoilijassa
- Avaa JSON-muotoilija ja tarkistin. Kenttään Syöte liitetään
{"demo":[1,2,]}. Valitse Muotoile kohdassa Tila ja sitten Suorita. - Odota virhettä, älä onnistuneesti muotoiltua tulosta. Sanamuoto voi vaihdella selaimen ja version mukaan; kopioi oman istuntosi ilmoitus. Pilkku juuri ennen merkkiä
]on virheellistä JSONia. - Korvaa Syöte arvolla
{"demo":[1,2]}ja valitse Suorita uudelleen. Tuloksen pitää sisältää ominaisuusdemoja kaksi lukua1ja2taulukossa. Välilyönnit ja sisennykset ovat muotoilua, eivät lisädataa. - Jäsennä tulos uudelleen tai vertaa arvoja ennen onnistumisen ilmoittamista. Työkalussa Text Compare voit verrata keksittyjä merkkijonoja näyttääksesi poistetun pilkun. Vertailu yksin ei validoi JSONia.
- Liitä raporttiin molemmat merkkijonot, tila, havaittu virhe ja korjattu tulos. Kerro, ettei skeemasääntöjä eikä vastaanottavaa sovellusta ole testattu. Valitse Tyhjennä tyhjentääksesi työkalun lopuksi.
Jos tulos poikkeaa
- Yhä virheellinen: tarkista lainausmerkit, sulkevat sulut ja vahingossa kopioitu teksti. Korjaa yksi synteettinen virhe kerrallaan; älä poista tuotantokenttiä satunnaisesti.
- Kelvollinen JSON, mutta sovellus hylkää sen: syntaksi ei todista pakollisia kenttiä, tyyppejä tai liiketoimintasääntöjä. Käytä sovelluksen dokumentoitua skeemaa hyväksytyssä yksityisessä ympäristössä.
- Varoitus toistuvasta avaimesta: älä peitä sitä uudelleenmuotoilulla. Eri vastaanottajat voivat tulkita samannimisiä ominaisuuksia eri tavoin; ilmaise tarkoitettu rakenne selvästi.
Usein kysyttyä
Anonymisoiko tämä tuotantotietueet?
Ei. Keksi näyte alusta asti. Muotoilu tai näkyvän nimen vaihtaminen ei takaa tunnisteiden poistumista.
Miksi kelvollinen tulos ei korjaa sovellustani?
Muotoilija tarkistaa ja muotoilee tuettua JSON-syntaksia. Se ei suorita sovelluksen skeemaa eikä arvoja koodina.