Perusteelliset käytännön oppaat

Säilytä julkisen aineiston toistettava versio

Yhdistä lähdetiedosto, päivämäärät, rakenne ja muunnokset, jotta aineisto voidaan löytää, vertailla ja käyttää uudelleen erottamalla päivitys, korjaus ja rajauksen muutos.

Päivitetty :

Tiedostojen ja taulukoiden tarkistus järjestetyllä työpisteellä.

Tekoälyllä luotu kuvitus

Voiko toinen lukija rakentaa tuloksen uudelleen?

Linkki muuttuvaan tietokantaan ei määritä käytettyjä tietoja. Korjaus voi muuttaa vanhoja sarjoja, vienti pudottaa alkunollat ja uusi sarake muuttaa summan merkitystä. Hyödyllinen versio selittää lähtöaineiston ja käsittelyn. Tavoite on kuvatun työn toistettavuus, ei yleinen takuu lähteen laadusta.

  1. Määritä rajaus

    Nimeä tuottaja, aineisto, alue, väestö, ajanjakso ja suodattimet. Erota havainto-, julkaisu- ja latauspäivät. Tänään saatu tiedosto voi kuvata vanhaa jaksoa. Kirjaa kysymys ja tulkinnalle tärkeät poissulut.

  2. Säilytä käytetty lähtöaineisto

    Kirjaa osoite tai julkiset parametrit, hakupäivä ja saatu tiedosto ehtojen salliessa. Anna versiotunniste ja laske tiedoston tiiviste. Tiiviste erottaa tiedostoja, mutta ei osoita arvojen oikeellisuutta. Säilytä lisenssitiedot.

  3. Kuvaa rakenne

    Dokumentoi kentät, tyypit, yksiköt, avaimet ja puuttuvat arvot. Tarkista CSV:n erotin, merkistö, lainausmerkit ja rivinvaihdot todellisesta viennistä. Säilytä alkunollia tarvitsevat tunnisteet tekstinä. Erota nolla, puuttuva ja soveltumaton arvo.

  4. Kirjaa muunnokset

    Kirjaa suodatus, normalisointi, yhdistely, konversiot ja kaksoiskappaleiden käsittely järjestyksessä. Erota raakasyöte valmistellusta tuloksesta. Säilytä yhdistelyavaimet ja ratkaisemattomat tapaukset. Samankaltainen nimi ei oikeuta yhdistämään toimijoita. Tee valinnat näkyviksi.

  5. Vertaa versioita

    Mittaa lisätyt, poistetut ja muuttuneet rivit vakaalla avaimella, jos sellainen on. Tarkista myös rakenne, yksiköt ja määritelmät. Rivimäärän muutos ei osoita ilmiön muutosta: syynä voivat olla suodatus, kattavuus tai tuottajan tarkistus.

  6. Valmistele uudelleenkäyttö

    Yhdistä tulos lähdeversioon, vaiheisiin ja rajoihin. Tarkista linkit tuottajaan ja asiayhteyteen. Valmistele uusi keruu vertailukriteereineen. Säilytä aiempaa julkaistua johtopäätöstä tukeva vanha versio erikseen sen ehtoja ja tietoja kunnioittaen.

Tietojen lukemisen työpaja

Korjattu arvo ei kirjoita tiedettyä historiaa uusiksi

DEMO-aineisto on kuvitteellinen. Sen versiot erottavat historiallisen analyysin korjattua dataa käyttävästä analyysistä.

Kuvitteellisia tietoja ja merkintöjä oppimista varten: tulokset eivät ole peräisin suorista palvelukyselyistä.

Huhtikuussa 80, kesäkuun korjauksen jälkeen 82

Tiedostoissa ovat sama avain ja ajanjakso. Kuvitteellinen tuottaja julkaisee korjausmerkinnän. Myöhempi luettelokuvauksen muutos ei muuta CSV:tä.

Jos taulukko ylittää näytön, vieritä vaakasuunnassa; nuolinäppäimet toimivat alueen ollessa kohdistettuna.

Huhtikuussa 80, kesäkuun korjauksen jälkeen 82
Kuvitteellinen tilaSaatavilla oleva aineistoMikä muuttuuIlmoitettava käyttö
v1 saatavilla huhtikuussaArvo 80 tutkittavalle avaimelleJulkaistu tila ennen korjaustaHuhtikuussa saatavilla ollutta kuvattaessa viittaa v1:een.
v2 julkaistu kesäkuussaKorjattu arvo 82 ja tarkistusmerkintäMenneen havainnon korjaus, ei uusi tapahtumaTarkistetussa analyysissä viittaa v2:een ja ilmoita korjaus.
Kuvaus muokattu v2:n jälkeenKuvaus selvennetty, CSV esimerkissä samaVain metatiedotÄlä päättele uutta arvoa kuvauksen päiväyksestä.
Molemmat analyysit säilytettyHistoriallinen tulos v1:llä; tarkistettu v2:llaAjallinen kysymys ja lähdeversioÄlä sekoita versioita ilmoittamatta.

Pitääkö huhtikuun tulos korvata huomaamatta?

Avaa jokainen väite ja vertaa sen tulkintaa. Lisätarkistuksia voi silti tarvita.

Kyllä: vain uusin tiedosto ansaitsee kirjauksen

Ei. Vanha versio voi selittää silloin julkaistun päätelmän.

Ei: ilmoita kysymys, versio ja korjaus

Kyllä. Erota huhtikuussa tiedetty kesäkuussa tarkistetusta analyysistä; liitä tulokset syötteeseensä.

Sama tiiviste vahvistaa datan laadun

Ei. Se koskee vertailtuja tavuja, ei luvun oikeellisuutta tai edustavuutta.

Kuvitteellinen versiokirjaus

Aineisto: DEMO; avain ja jakso ennallaan
v1: saatavilla huhtikuussa; arvo=80
v2: julkaistu kesäkuussa; korjattu arvo=82
Syy: kuvitteellisen tuottajan dokumentoima korjaus
Myöhempi kuvaus: vain teksti, CSV ennallaan
Tulokset: historiallinen liittyy v1:een; tarkistettu v2:een

Kirjaus säilyttää molemmat analyysikysymykset. Tiivisteet tunnistavat käytetyt tiedostot tekemättä tallennetusta versiosta totta.

Sääntöjen dokumentaatio erillään kuvitteellisista esimerkeistä

Vertaa muita tilanteita ja harjoituksia

Tunnisteet muuttuvat avattaessa

Ohjelma tulkitsee sarakkeen numeroiksi ja pudottaa alkunollat. Palaa raakavientiin, aseta avain tekstiksi ja tarkista yhdistelyt. Muuttuneen arvon ulkoasun korjaus ei aina palauta alkuperäistä tunnistetta.

Historiallinen sarja tarkistetaan

Uusi tiedosto korvaa myös vanhoja arvoja. Vertaa jaksoittain ja avaimittain, säilytä versiot ja lue tuottajan huomautukset. Erota tarkistukset uusista havainnoista ennen trendin kuvaamista.

Tiedosto kasvaa ilman mitattua parannusta

Kattavuuteen lisättiin alueita tai luokkia. Vertaa yhteistä rajausta ja esitä laajennus erikseen. Kirjaa kenttien muutokset ja puuttuvat tiedot olettamatta kaikkia rivejä vertailukelpoisiksi.

Erota puuttuminen ja muutos

Kuvitteellinen esimerkki: A muuttuu arvosta 10 arvoon 11, B poistuu ja C lisätään. Avaimella id saadaan yksi lisätty avain, yksi poistettu avain ja yksi muuttunut yhteinen tietue. Uusi sarake luetellaan erikseen ilman keksittyä aiempaa arvoa. Pelkkä järjestyksen muutos ei muuta tulosta.

Harjoitus ja ratkaisu

Erota tarkistus ja lisäys kasvussa

Kuvitteellinen esimerkki: arvot ja asiakirjat opettavat menetelmää eivätkä kuvaa todellista organisaatiota.

Avaimet ovat yksilöllisiä, arvot summattavia ja sanasto ennallaan. Poistoja ei ole; puuttuminen tarkoittaa avaimen puuttumista versiosta.

Jos taulukko ylittää näytön, vieritä vaakasuunnassa; nuolinäppäimet toimivat alueen ollessa kohdistettuna.

Lähtötiedot
AvainVersio V1Versio V2
A1010
B2025
CPuuttuu5

Tarkistettavat asiat

  1. Vertaa rivejä tarkan avaimen mukaan.
  2. Erota B:n tarkistus C:n lisäyksestä.
  3. Täsmäytä summien ero.
Lue ratkaisu

Ratkaisu ja päätös

V1:n summa on 30 ja V2:n 40: +10. Yhteisillä avaimilla B:n tarkistus selittää +5; uusi C lisää +5. A on ennallaan. Kokonaissumman 33,33 %:n kasvua ei pidä selittää kokonaan aiempien kohteiden kasvulla.

Jos tilanne muuttuu

Jos V2 muuttaa yksikköä tai määritelmää, keskeytä erittely kunnes vertailukelpoisuus tarkistetaan.

Säilytettävä jälki

Säilytä viennit ja tiivisteet, sanastot, lisätyt/muuttuneet avaimet ja täsmäytyskaava.

Säilytettävä näyttö

  • Tuottaja, osoite, julkiset parametrit, lisenssi ja erilliset päivämäärät.
  • Versio, tiiviste, rakenne, yksiköt ja puuttuvien arvojen käytännöt.
  • Muunnosten järjestys, yhdistelyavaimet ja ratkaisemattomat tapaukset.
  • Versiovertailu, uudelleen rakennettu tulos ja tulkinnan rajat.

Viralliset lähteet

Aiheeseen liittyvät protokollat

Tarkistukset ennen johtopäätöstä

  • Säilyttääkö tunniste merkkinsä täsmälleen tuonnin ja viennin jälkeen, myös alkunollat?
  • Erottaako vertailu arvojen, rakenteen ja kattavuuden muutokset sen sijaan, että kaikki erot tiivistettäisiin rivimääräksi?
  • Voiko toinen lukija rekonstruoida tuloksen säilytetystä versiosta ja dokumentoidusta muunnosjärjestyksestä?

Usein kysytyt kysymykset

Pitääkö jokainen vienti säilyttää?

Säilytä työlle ja julkaistuille päätelmille tarpeelliset versiot määritellyn säännön mukaan. Vältä tarkoituksettomia kopioita ja noudata säilytys- ja käyttöehtoja.

Takaako tiiviste laadun?

Ei. Se tunnistaa tiedoston sisältöä ja muutoksia, mutta ei vahvista alkuperää, tulkintaa tai arvoja.

Voiko rivejä yhdistää nimellä?

Tarkista avaimet, asiayhteys ja samannimiset ensin. Säännön on käsiteltävä epäselvyydet ja kirjattava yhdistelyt.

Miten korjatut tiedot esitetään?

Ilmoita versio ja korjaus erottaen tarkistettu tulos aiemmasta. Älä esitä tarkistusta uutena havaintona.

Miksi toistuvat avaimet hylätään?

Sama tunniste kahdella rivillä tekee yhdistämisestä epäselvää. Tarkista tarkkuustaso, ajanjakso ja alkuperä; määritä tarvittaessa yhdistelmäavain. Älä poista riviä ennen kuin erotat kaksoiskappaleen erillisestä havainnosta.

Mitä säilytetään tietojen version kanssa?

Tiedosto, sen alkuperä, päivämäärä, jäljennös ja hyödyllinen asiakirja. Liittämällä jalostuksen säännöt ja viittaus tuotteiden tuloksiin helpottaa jälkeistä toistamista ja vertailua.

DOKUMENTOIDUT TIEDOT

PROV: versio, prosessi ja vastuu

W3C:n PROV-O kuvaa tiedon alkuperää. Nuolet seuraavat ominaisuuksia, eivät vasemmalta oikealle kulkevaa aikaa. E0, A ja E1 ovat opetusnimiä.

E0 · EntityA · ActivityE1 · EntityusedwasGeneratedBywasDerivedFrom
PROV: versio, prosessi ja vastuu
ViiteArvo tai muotoMitä se yksilöi
prov:EntityTieto/dokumentti kuvatussa tilassaEntity on kuvatussa tilassa oleva tieto; erota versiot muuttuvan URL:n sijaan.
prov:ActivityAjallinen prosessiActivity on ajallinen prosessi, ei sen tulos.
prov:AgentHenkilö, organisaatio tai ohjelmistoagenttiAgent kantaa vastuuta. wasAttributedTo yhdistää entiteetin agenttiin, wasAssociatedWith toiminnan agenttiin; ei lisenssitodistus.
prov:usedActivity → Entityused kulkee toiminnasta entiteettiin: A käyttää E0:aa.
prov:wasGeneratedByEntity → ActivitywasGeneratedBy kulkee tuloksesta toimintaan: A generoi E1:n.
prov:wasDerivedFromEntity → EntitywasDerivedFrom kulkee tuloksesta lähteeseen ilman kaavaa, painoja tai oikeellisuustodistusta.
prov:wasRevisionOfEntity → EntityRevision säilyttää olennaista alkuperäissisältöä; viittaus ei aina ole revisio.
prov:wasQuotedFromEntity → EntityKatkelma toistetaan laajemmasta lähteestä. Säilytä tarkka sanamuoto ja sijainti: pelkkä suhde ei paikanna sanoja.

Lainaus, käännös vai uusi versio?

Neljä kuvitteellista tapausta osoittaa, miksi suhteen pitää kuvata todellista muunnosta. Tulos on suhteen subjekti, lähde tai toimija on oikealla.

Kopioitu katkelma

quote → prov:wasQuotedFrom → source-v1

Katkelma toistetaan laajemmasta lähteestä. Säilytä tarkka sanamuoto ja sijainti: pelkkä suhde ei paikanna sanoja.

Käännös

translation → prov:wasDerivedFrom → source-v1

Käännös on uusi johdettu entiteetti. Säilytä lähtö- ja kohdekieli, versio ja uskollisuuden tarkistus; erota käännös alkuperäisestä katkelmasta.

Asiakirjan korjaus

source-v2 → prov:wasRevisionOf → source-v1

Korjattu versio säilyttää olennaista sisältöä edeltäjästään. Säilytä molemmat tilat ja muutokset; suhde ei ratkaise, kumpi versio on oikea.

Tuloksen tekijä

analysis → prov:wasAttributedTo → editor

Entiteetti liitetään toimijaan. Prosessin vastuuta kuvaa Activity → prov:wasAssociatedWith → Agent. Tekijän nimeäminen ei vahvista uudelleenkäyttöoikeuksia.

Alkuperätieto kuvaa ilmoitettua ketjua. Se ei tee käännöksestä riippumatonta näyttöä eikä tekijätiedosta sisällön tarkistusta.

Huomioitavaa aineistossa

Kuvaa tunnettu keksimättä puuttuvaa. Alkuperä ei automaattisesti vahvista laskua, oikeuksia tai aitoutta. Säilytä versiot ja lähteet.

Riittääkö wasDerivedFrom toistamaan tunnusluvun?

Ei: tarvitaan versiot, suodattimet, kaava, parametrit ja puuttuvuussäännöt.

Alkuperäisdokumentaatio

Dokumentaatio tarkistettu .

DOKUMENTOIDUT TIEDOT

Osien yhdistäminen: kattavuus, aukot ja esityksen identiteetti

Vastaanotettujen pituuksien summa voi peittää keskeneräisen siirron: päällekkäisyys laskee samat paikat useasti. Laske välien unioni ja vertaa sitä aiottuun esitykseen. Geometrinen tarkistus ei korvaa tavujen ja alkuperän tarkistamista.

Osien yhdistäminen: kattavuus, aukot ja esityksen identiteetti
ViiteArvo tai muotoMitä se yksilöi
0-399,300-599,700-999Σ = 1000; ∪ = 900Kun L = 1 000, osat 0–399, 300–599 ja 700–999 sisältävät yhteensä 1 000 ilmoitettua tavua. Unioni kattaa vain 900 paikkaa: 600–699 puuttuu ja 100 tavun vastaanottoa on ylimääräisiä.
0-499,500-999∪ = 1000Vierekkäiset välit yhdistyvät ilman aukkoa: 0–499 ja 500–999 kattavat 1 000 paikkaa. Saman tavun vastaanotto kolmesti lisää kaksi ylimääräistä vastaanottoa, ei kahta erillistä päällekkäistä paikkaa.
Content-Rangefirst ≤ last < LVastauksen Content-Range-kentän loppu ei saa olla alkua pienempi. Tunnetun kokonaispituuden on oltava loppua aidosti suurempi. Tähdellä * ilmoitettu tuntematon pituus ei osoita täyttä kattavuutta.
ETagstrong validatorOsien on kuuluttava samaan esitykseen. RFC 9111 edellyttää yhteistä vahvaa validaattoria ja HTTP:n yhdistämisehtoja, kun välimuisti yhdistää osittaisia vastauksia. Sama URL tai pituus ei korvaa tätä tarkistusta.
If-Rangestrong comparisonIf-Range käyttää vahvaa ETag-vertailua. Asiakas ei saa lähettää siinä heikkoa ETag-arvoa. Ehdon epäonnistuessa Range ohitetaan ja pyydetään koko siirto. Päiväys kelpaa vain HTTP:n vahvan validaattorin ehdoilla.

Tarkista osien kattavuus

Alkuperäisiä opetusesimerkkejä; ei todellisen palvelimen mittauksia.

L: kokonaisluku väliltä 1–1 000 000 000 000. Syötä 1–20 molemmat rajat sisältävää a-b-väliä, yksi riville, esityksen sisällä. Tyhjät rivit ohitetaan; ympäröivät välilyönnit ja sarkaimet sallitaan. Enintään 2 000 merkkiä; ei HTTP-otsaketta.

Laskenta tapahtuu selaimessa; syötettyjä tietoja ei lähetetä eikä tallenneta.

Laskenta päivitetty.

Ilmoitettujen pituuksien summa
1000
Katetut erilliset paikat
900
Ylimääräiset tavujen vastaanotot
100
Puuttuvat paikat
100

Vain aritmeettinen kattavuus: esityksen identiteetti ja tavujen eheys on tarkistettava erikseen.

Esityksen kattavuusPalkki vasemmalta oikealle: paikat nollasta arvoon L − 1. Yhtenäiset osat on katettu, viivoitetut puuttuvat. Taulukko antaa tarkat rajat; hyvin pienet alueet voivat jäädä tässä mittakaavassa näkymättömiksi.0999
Palkki vasemmalta oikealle: paikat nollasta arvoon L − 1. Yhtenäiset osat on katettu, viivoitetut puuttuvat. Taulukko antaa tarkat rajat; hyvin pienet alueet voivat jäädä tässä mittakaavassa näkymättömiksi.
Osien unioni
Rajansa sisältävä väliPituus
0–599600
700–999300
Puuttuvat välit
Rajansa sisältävä väliPituus
600–699100

Laskentasäännöt

sum = Σ(lastᵢ − firstᵢ + 1)
unique = |∪ intervals|
redundant = sum − unique
missing = L − unique
Kahdeksan kattavuusesimerkkiä
Kahdeksan kattavuusesimerkkiä
LIlmoitetut osat (a-b, yksi riville)Ilmoitettujen pituuksien summaKatetut erilliset paikatYlimääräiset tavujen vastaanototPuuttuvat paikatPuuttuvat välit
10000–399; 300–599; 700–9991000900100100600–699
10000–499; 500–9991000100000Ei yhtään
10000–999; 0–9992000100010000Ei yhtään
100–0; 0–0; 0–031291–9
109–9; 0–022081–8
102–7; 3–486240–1; 8–9
10–01100Ei yhtään
10000000000000–999999999998; 999999999999–9999999999991000000000000100000000000000Ei yhtään

Huomioitavaa aineistossa

Kattavuus olettaa ilmoitetut paikat samasta esityksestä. Työkalu ei lue tiedostoja eikä tarkista ETag-arvoja, Content-Encoding-koodausta, välimuistia tai tiivistettä. Se ei osoita päällekkäisten tavujen yhtäläisyyttä. Täysi kattavuus ei ole eheystodistus.

Todistaako sama ETag asiakirjan aitouden?

Ei. ETag on HTTP-validaattori, ei välttämättä kryptografinen tiiviste tai tekijän allekirjoitus. Tarkista myös variantti, pituudet ja todella vastaanotetut tavut. Kirjaa alkuperä ja eheystarkistukset erikseen.

Alkuperäisdokumentaatio

Dokumentaatio tarkistettu .

DOKUMENTOIDUT TIEDOT

JSON Patch: seuraa operaatioita nykyisessä dokumentissa

JSON Patch -lista arvioidaan järjestyksessä. Kukin polku osoittaa edellisten operaatioiden tuottamaan dokumenttiin, ei alkuperäisen pysyvään tilannekuvaan. Yhdeksän alkuperäistä esimerkkiä näyttävät laskentatilat ja pysähtymisehdot.

JSON Patch: seuraa operaatioita nykyisessä dokumentissa
ViiteArvo tai muotoMitä se yksilöi
addinsert / replaceadd lisää taulukon indeksiin ja siirtää myöhempiä alkioita; loppuviiva lisää viimeisen jälkeen. Oliossa add myös korvaa olemassa olevan jäsenen. Ylätason säiliön on oltava olemassa.
remove / replaceexisting targetremove ja replace edellyttävät olemassa olevaa kohdetta. Taulukon alkion poistaminen siirtää suurempia indeksejä vasemmalle: sama polku voi myöhemmin valita eri alkion.
moveremove → addmove poistaa ensin from-arvon ja lisää sen sitten path-kohtaan muuttuneessa dokumentissa. Myöhempään paikkaan siirrettäessä käytetään uusia indeksejä. Siirto omaan varsinaiseen jälkeläiseen on kielletty.
copy / testvalue / equalitycopy lisää arvon sitomatta paikkoja toisiinsa. test vertaa JSON-säännöillä, ei kirjoita mitään ja pysäyttää arvioinnin epäonnistuessaan. Olion jäsenten järjestys ei vaikuta yhtäsuuruuteen.
HTTP PATCHatomicVirhe pysäyttää sarjan. HTTP PATCH edellyttää atomista toteutusta: epäonnistunut patch ei toteuta mitään muutosta. Lukijan välitilat selittävät laskentaa eivätkä ole vahvistettuja kirjoituksia.
Content-Typepatch formatContent-Type erottaa tyypit application/json-patch+json ja application/merge-patch+json. PATCH-tuki ei takaa molempia. HTTP-esiehto kuten If-Match voi estää vanhentuneeseen versioon kohdistuvan päivityksen; test ei automaattisesti korvaa sitä.

Lue JSON Patch -sarja

Alkuperäisiä opetusesimerkkejä; oikeaa dokumenttia ei muuteta.

Valitse esimerkki ja vaihe. Kukin operaatio kohdistuu edelliseen tulokseen. Virheen jälkeen lukija näyttää alkukohteen HTTP:n atomisuuden havainnollistamiseksi; myöhempiä operaatioita ei suoriteta.

Valmiiden esimerkkien lukija; vapaata patchia ei suoriteta tässä.

Alkutila · 0 / 2

Alkuperäinen kohde

{
    "items": [
        "A",
        "B",
        "C"
    ]
}

Operaatio

Ei operaatiota tässä vaiheessa.

Laskentatila

{
    "items": [
        "A",
        "B",
        "C"
    ]
}
Yhdeksän esimerkkiä kaikkine tiloineen
Poisto ja indeksien siirtyminen
  1. Alkutila

    Ei operaatiota tässä vaiheessa.

    Laskentatila

    {
        "items": [
            "A",
            "B",
            "C"
        ]
    }
  2. Välitila, ei vahvistettu

    Operaatio

    {
        "op": "remove",
        "path": "/items/0"
    }

    Laskentatila

    {
        "items": [
            "B",
            "C"
        ]
    }
  3. Sarja onnistui

    Operaatio

    {
        "op": "replace",
        "path": "/items/1",
        "value": "X"
    }

    Laskentatila

    {
        "items": [
            "B",
            "X"
        ]
    }
Lisäys indeksiin ja loppuun
  1. Alkutila

    Ei operaatiota tässä vaiheessa.

    Laskentatila

    [
        "A",
        "C"
    ]
  2. Välitila, ei vahvistettu

    Operaatio

    {
        "op": "add",
        "path": "/1",
        "value": "B"
    }

    Laskentatila

    [
        "A",
        "B",
        "C"
    ]
  3. Sarja onnistui

    Operaatio

    {
        "op": "add",
        "path": "/-",
        "value": "D"
    }

    Laskentatila

    [
        "A",
        "B",
        "C",
        "D"
    ]
Null-arvo ja poistaminen
  1. Alkutila

    Ei operaatiota tässä vaiheessa.

    Laskentatila

    {
        "note": "old",
        "keep": true
    }
  2. Välitila, ei vahvistettu

    Operaatio

    {
        "op": "replace",
        "path": "/note",
        "value": null
    }

    Laskentatila

    {
        "note": null,
        "keep": true
    }
  3. Sarja onnistui

    Operaatio

    {
        "op": "remove",
        "path": "/note"
    }

    Laskentatila

    {
        "keep": true
    }
Kopio ilman sidosta
  1. Alkutila

    Ei operaatiota tässä vaiheessa.

    Laskentatila

    {
        "source": {
            "n": 1
        }
    }
  2. Välitila, ei vahvistettu

    Operaatio

    {
        "op": "copy",
        "from": "/source",
        "path": "/backup"
    }

    Laskentatila

    {
        "source": {
            "n": 1
        },
        "backup": {
            "n": 1
        }
    }
  3. Sarja onnistui

    Operaatio

    {
        "op": "replace",
        "path": "/source/n",
        "value": 2
    }

    Laskentatila

    {
        "source": {
            "n": 2
        },
        "backup": {
            "n": 1
        }
    }
Siirto poiston jälkeen
  1. Alkutila

    Ei operaatiota tässä vaiheessa.

    Laskentatila

    [
        "A",
        "B",
        "C",
        "D"
    ]
  2. Sarja onnistui

    Operaatio

    {
        "op": "move",
        "from": "/1",
        "path": "/3"
    }

    Laskentatila

    [
        "A",
        "C",
        "D",
        "B"
    ]
Testin virhe ja atomisuus
  1. Alkutila

    Ei operaatiota tässä vaiheessa.

    Laskentatila

    {
        "rev": 1,
        "label": "A"
    }
  2. Välitila, ei vahvistettu

    Operaatio

    {
        "op": "replace",
        "path": "/label",
        "value": "B"
    }

    Laskentatila

    {
        "rev": 1,
        "label": "B"
    }
  3. Virhe: HTTP PATCH ei toteuta muutoksia

    Operaatio

    {
        "op": "test",
        "path": "/rev",
        "value": 2
    }

    Laskentatila

    {
        "rev": 1,
        "label": "A"
    }
  4. Ei suoritettu virheen jälkeen

    Operaatio

    {
        "op": "add",
        "path": "/extra",
        "value": true
    }

    Laskentatila

    {
        "rev": 1,
        "label": "A"
    }
Puuttuva yläolio
  1. Alkutila

    Ei operaatiota tässä vaiheessa.

    Laskentatila

    {
        "a": []
    }
  2. Virhe: HTTP PATCH ei toteuta muutoksia

    Operaatio

    {
        "op": "add",
        "path": "/missing/x",
        "value": 1
    }

    Laskentatila

    {
        "a": []
    }
Koodattu polku ja juuri
  1. Alkutila

    Ei operaatiota tässä vaiheessa.

    Laskentatila

    {
        "a/b": {
            "~key": 1
        }
    }
  2. Välitila, ei vahvistettu

    Operaatio

    {
        "op": "test",
        "path": "/a~1b/~0key",
        "value": 1
    }

    Laskentatila

    {
        "a/b": {
            "~key": 1
        }
    }
  3. Sarja onnistui

    Operaatio

    {
        "op": "add",
        "path": "",
        "value": [
            "root"
        ]
    }

    Laskentatila

    [
        "root"
    ]
add olemassa olevaan jäseneen
  1. Alkutila

    Ei operaatiota tässä vaiheessa.

    Laskentatila

    {
        "x": 1
    }
  2. Sarja onnistui

    Operaatio

    {
        "op": "add",
        "path": "/x",
        "value": 2
    }

    Laskentatila

    {
        "x": 2
    }

Huomioitavaa aineistossa

Lukija näyttää dokumentoituja esimerkkejä eikä ole yleinen JSON Patch -suoritin. Se ei ota yhteyttä palvelimeen eikä ennusta vastauskoodia. Esitetty atomisuus kuuluu HTTP PATCHiin; paikallisen kirjaston on kuvattava omat virhe- ja muutoskäytäntönsä.

Määrääkö PATCH yksin sisällön käsittelyn?

Ei. Tarvitaan mediatyyppi ja resurssin sopimus. Accept-Patch voi ilmoittaa hyväksytyt muodot. Menetelmän nimi tai paikallinen esimerkki ei todista etärajapinnan tukea tai muutosoikeutta.

Alkuperäisdokumentaatio

Dokumentaatio tarkistettu .

DOKUMENTOIDUT TIEDOT

SemVer: vertaa järjestystä päättelemättä identiteettiä

SemVer 2.0.0 määrittelee syntaksin ja järjestyksen ohjelmistoversioille, joilla on ilmoitettu julkinen API. Tavallinen merkkijono- tai desimaalilukuvertailu antaa vääriä tuloksia. Aineiston päiväys tai tagin nimi ei automaattisesti noudata tätä sopimusta.

SemVer: vertaa järjestystä päättelemättä identiteettiä
ViiteArvo tai muotoMitä se yksilöi
MAJOR.MINOR.PATCH0 | [1-9][0-9]*Ydin koostuu kolmesta ei-negatiivisesta kokonaisluvusta: MAJOR.MINOR.PATCH. Etunollat kielletään paitsi yksittäinen 0. Tagi v1.2.3 voi nimetä julkaisun, mutta koko merkkijono ei ole tiukka SemVer-versio.
1.9.0 / 1.10.0numericYdinluvut verrataan numeerisesti vasemmalta oikealle. Siksi 1.9.0 edeltää versiota 1.10.0. SemVer ei rajoita luvun pituutta: työkalu vertaa numeroita ilman liukulukumuunnosta.
-alpha.1pre-releaseYtimien ollessa samat esiversio edeltää tavallista versiota. Pisteillä erotetut tunnisteet eivät saa olla tyhjiä. Pelkkä numerotunniste ei salli etunollia; kirjaimen tai yhdysmerkin sisältävä tunniste on eri tapaus.
-2 / -alphanumeric < non-numericNumerotunnisteita verrataan numeerisesti, muita ASCII-järjestyksessä. Numerotunniste edeltää muuta tunnistetta. Kun kaikki yhteiset tunnisteet ovat samoja, useampia tunnisteita sisältävä esiversio on järjestyksessä suurempi.
+001ignored in precedencePlusmerkin jälkeinen koontimetadata ei koskaan vaikuta järjestykseen. Toisin kuin esiversion numerotunniste, se voi sisältää arvon 001. Eri merkkijonot voivat olla samanarvoisia järjestyksessä todistamatta tiedostojen yhtäläisyyttä tai artefaktien vaihdettavuutta.

Vertaa kahta SemVer-versiota

Alkuperäisiä opetusesimerkkejä; todellista julkaisua ei arvioida.

Kaksi tiukkaa SemVer 2.0.0 -versiota, enintään 256 ASCII-merkkiä kumpikin. Ei välilyöntejä, v-etuliitettä tai rajoiteoperaattoreita. Numerotunnisteet verrataan täsmällisesti ilman pyöristystä.

Paikallinen laskenta selaimessa; syötettä ei lähetetä eikä tallenneta.

A edeltää B:tä SemVer-järjestyksessä.

1.9.0 < 1.10.0

Ensimmäinen ratkaiseva kriteeri : MINOR

Versioiden osat
OsaVersio AVersio B
MAJOR11
MINOR910
PATCH00
EsiversioEi mitäänEi mitään
KoontimetadataEi mitäänEi mitään
Kymmenen järjestysvertailua
Kymmenen järjestysvertailua
Versio A< / = / >Versio BEnsimmäinen ratkaiseva kriteeri
1.9.0<1.10.0MINOR
2.0.0>1.99.99MAJOR
1.0.9<1.0.10PATCH
1.2.3-rc.9<1.2.3Esiversio verrattuna tavalliseen
1.2.3-alpha.2<1.2.3-alpha.11Esiversiotunniste
1.2.3-9<1.2.3-alphaEsiversiotunniste
1.2.3-alpha<1.2.3-alpha.0Esiversiotunnisteiden määrä
1.2.3-Beta<1.2.3-alphaEsiversiotunniste
1.2.3+linux.001=1.2.3+windows.002Metadata ei vaikuta järjestykseen
9007199254740992.0.0<9007199254740993.0.0MAJOR
Kymmenen tiukan syntaksin tapausta
Kymmenen tiukan syntaksin tapausta
SyöteDiagnoosi
1.2.3Kelvollinen
0.0.0-0Kelvollinen
1.2.3+001Kelvollinen
1.2.3-01aKelvollinen
1.2.3--Kelvollinen
v1.2.3Virheellinen
1.02.3Virheellinen
1.2.3-01Virheellinen
1.2.3-alpha..1Virheellinen
1.2.3+Virheellinen

Alkuperäinen tulkinta ja esimerkit perustuvat Tom Preston-Wernerin alun perin laatimaan SemVer 2.0.0:aan; viiteteksti lisenssillä CC BY 3.0. SemVer 2.0.0 · CC BY 3.0

Jatka tarkistusta

Huomioitavaa aineistossa

Vertailija tarkistaa syntaksin ja järjestyksen, ei julkaisutietoja, sisältöä, turvallisuutta tai todellista yhteensopivuutta. Riippuvuusrajoja, npm-välejä tai Python- ja Debian-versioita ei käsitellä. 256 merkin raja kuuluu lomakkeelle, ei SemVerille.

Pitääkö samanarvoiset versiot yhdistää luetteloon?

Ei automaattisesti. Säilytä koko merkkijono ja artefaktiviite: 1.2.3+linux ja 1.2.3+windows ovat järjestyksessä samanarvoisia, mutta metadata voi erottaa koonnit. Tiiviste ja julkaisusopimus tarkistetaan erikseen.

Alkuperäisdokumentaatio

Dokumentaatio tarkistettu .

SYVENTÄVÄ LUKEMINEN / KÄYTÄNTÖ

Säilytä aineistoversioiden väliset erot

Julkinen tiedosto korvataan samassa paikassa. Versioinnin on voitava palata laskelmassa käytetyn tilan ja ymmärtää myöhemmät muutokset.

Päivitetty .

Ensisijaiset tarkistukset

Säilytä tiedosto, päivämäärä, lähde, jäljennös ja kaava. Vertaile rivejä, sarakkeita, määritelmiä ja arvoja ennen eroja mitattu ilmiön kehitykseen.

Tulkinnan sudenkuopat

Uusi latauspäivä ei välttämättä tarkoita uutta sisältöä. Rakenteen muutos voi tehdä raaka vertailun vaikeaksi tulkita.

Säilytettävä työasiakirja

Versiotiedote yhdistää tilan, jäljennös, muutos ja vaikutus analyyseihin. Laskelmat viittaavat nimenomaisesti käytettyyn versioon.