ChangeLog - Skilaboðategundir

Þetta skjal fjallar um þrjár skilaboðategundir sem setja BC-breytingaskrána (Change Log) fram til skoðunar á reitastigsstigum, endurheimtu og stöðuprófa.

Yfirlit

Forskilyrði: BC-breytingaskráin verður að vera stillt fyrir hlutaðeigandi töflur og reiti (Stjórnun → Uppsetning breytingaskrár → Töflur). Án breytingaskráarfærslna er engin saga til að skoða eða endurheimta.

Dæmigerð vinnuferli:

1. Kalla ChangeLog.Field.Enabled til að staðfesta að reitur sé rakinn.
2. Kalla ChangeLog.Field.History til að skoða breytingar og velja entryNo sem miðast að.
3. Kalla ChangeLog.Field.Restore með þetta entryNo til að skrifa gildið aftur.

ChangeLog.Field.History

Stefna: Útlæg Hlutkenni: Kóðaeining 65415 (ChangeLog Field History Impl), Kóðaeining 65416 (ChangeLog Field History Help)

Tilgangur

Skilar núgildandi gildi reits ásamt öllum breytingaskráarfærslum fyrir þann reit á tiltekinni færslu, raðað frá nýjasta til elsta.

Svarið byrjar alltaf með þjálfunarlegri Current færslu við entryNo = 0 sem sýnir gildandi reitgildi. Þetta gerir það auðvelt fyrir kallara að bera saman núverandi stöðu við söguleg gögn án sérstaks uppflettings.

Snið beiðni

{
  "specversion": "1.0",
  "type": "ChangeLog.Field.History",
  "source": "MyApp v1.0",
  "data": "{\"tableName\":\"Customer\",\"recordSystemId\":\"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\"fieldNo\":2}"
}

Inntaksfæribreytur

*Ef recordSystemId vantar í gagnafærslu, er subject-eigind CloudEvents notuð sem GUID-varabú.

Snið svars

{
  "status": "Success",
  "tableNo": 18,
  "tableName": "Customer",
  "recordSystemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "fieldNo": 2,
  "fieldName": "Name",
  "fieldType": "Text",
  "history": [
    {
      "entryNo": 0,
      "dateAndTime": "2026-03-28T14:22:00.000Z",
      "typeOfChange": "Current",
      "oldValue": "",
      "newValue": "Contoso Ltd.",
      "userId": "ADMIN"
    },
    {
      "entryNo": 56789,
      "dateAndTime": "2026-03-10T09:00:00.000Z",
      "typeOfChange": "Modification",
      "oldValue": "Contoso Inc.",
      "newValue": "Contoso Ltd.",
      "userId": "ADMIN"
    },
    {
      "entryNo": 45001,
      "dateAndTime": "2025-11-15T11:30:00.000Z",
      "typeOfChange": "Modification",
      "oldValue": "Contoso",
      "newValue": "Contoso Inc.",
      "userId": "JANE"
    }
  ],
  "totalCount": 3
}

Reitir á efsta stigi svars

Reitir sögulegrar færslu

Villutilvik

ChangeLog.Field.Restore

Stefna: Innlæg (skrif) Hlutkenni: Kóðaeining 65412 (ChangeLog Field Restore Impl), Kóðaeining 65413 (ChangeLog Field Restore Help), Kóðaeining 65414 (ChangeLog Field Restore Process)

Tilgangur

Skrifar fyrra reitgildi aftur í lifandi Business Central færsluna. Gildið er tekið úr Old Value völdrar breytingaskráarfærslu. Endurheimtan er framkvæmd með Validate() + Modify(true) svo allar viðskiptalegifraðar á reitastigi keyri eðlilega.

Styður tvær stillingar:

Stilling 1: Eftir færslunúmeri

{
  "specversion": "1.0",
  "type": "ChangeLog.Field.Restore",
  "source": "MyApp v1.0",
  "data": "{\"entryNo\":56789}"
}

Stilling 2: Eftir tímapunkti

{
  "specversion": "1.0",
  "type": "ChangeLog.Field.Restore",
  "source": "MyApp v1.0",
  "data": "{\"tableName\":\"Customer\",\"recordSystemId\":\"a1b2c3d4-e5f6-7890-abcd-ef1234567890\",\"fieldNo\":2,\"restoreToDateTime\":\"2026-02-10T09:15:00Z\"}"
}

Snið svars

{
  "status": "Success",
  "tableNo": 18,
  "tableName": "Customer",
  "recordSystemId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "fieldNo": 2,
  "fieldName": "Name",
  "previousValue": "Contoso Ltd.",
  "restoredValue": "Contoso Inc.",
  "fromEntryNo": 56789,
  "entryDateTime": "2026-02-10T09:15:00.000Z"
}

Öryggisvarðar

Eftirfarandi skilyrði verða öll að uppfyllast eða endurheimta er hafnað:

• Tegund færslu verður að vera Modification — Insertion- og Deletion-færslur geta ekki verið endurheimtar
• Markmið-færsla verður enn að vera til
• Reitur verður að vera skrifanlegur (Normal-flokkur) — FlowFields og FlowFilters eru hafnað
• Reitur má ekki vera skriflokaður (Cloud Events Field Access)
• Taflan má ekki vera takmörkuð fyrir skrifaðgerðir (Cloud Events Setup)
• Reitur verður að vera leyfður af ChangeLog Write Guard stillingunni í Cloud Events Setup
• Endurheimtugildi verður að vera umbreytanlegt í gagnategund reitsins
• Núverandi reitgildi verður að vera frábrugðið endurheimtugildi (eins gildi skilar villu, engin skrif gerð)

Villutilvik

ChangeLog.Field.Enabled

Stefna: Útlæg Hlutkenni: Kóðaeining 65362 (ChangeLog FieldEnabled Impl), Kóðaeining 65363 (ChangeLog FieldEnabled Help)

Tilgangur

Athugar hvort:

1. BC-breytingaskráin sé virk á víðan svið.
2. ChangeLog Write Guard sé í gildandi stillingu (Blocked eða Via force).
3. Tiltekinn reitur sé á breytingaskráruppsetningunni fyrir Modification-rakningu.

Gagnlegt áður en skrifað er í gegnum Data.Records.Set þegar ChangeLog Write Guard er virkur, eða áður en ChangeLog.Field.Restore er kallað til að staðfesta að reitur hafi sögu.

Snið beiðni

{
  "specversion": "1.0",
  "type": "ChangeLog.Field.Enabled",
  "source": "MyApp v1.0",
  "data": "{\"tableName\":\"Customer\",\"fieldNo\":2}"
}

Snið svars

{
  "status": "Success",
  "changeLogEnabled": true,
  "changelogWriteGuardEnabled": true,
  "tableNo": 18,
  "tableName": "Customer",
  "fieldNo": 2,
  "fieldName": "Name",
  "fieldCovered": true,
  "fieldWriteGuardBypassed": false
}

Villutilvik

ChangeLog.Records.Delta

Stefna: Útlæg Hlutkenni: Kóðaeining 65555 (ChangeLog Records Delta Impl), Kóðaeining 65556 (ChangeLog Records Delta Help)

Tilgangur

Skilar einkvæmum SystemId fyrir færslur í einni töflu sem voru settar inn eða breyttar innan tímabils. Hægt er að þrengja leitina við ákveðna reiti. Notist sem grunnur fyrir lotusamstillingu: sækið breyttu auðkennin, kallið síðan Data.Records.Get fyrir hverja færslu og ChangeLog.Field.History fyrir dýpri rakningu.

Eyðingar eru ekki skilaðar — notið Deleted.RecordIds.Get fyrir eyddar færslur.

Beiðnasnið

{
  "specversion": "1.0",
  "type": "ChangeLog.Records.Delta",
  "source": "MyApp v1.0",
  "subject": "Customer",
  "data": "{\"tableName\":\"Customer\",\"fieldNumbers\":[2,3],\"startDateTime\":\"2026-03-01T00:00:00Z\",\"endDateTime\":\"2026-03-31T23:59:59Z\"}"
}

Inntakssvið

Svarsnið

{
  "status": "Success",
  "tableNo": 18,
  "tableName": "Customer",
  "fieldNumbers": [2, 3],
  "startDateTime": "2026-03-01T00:00:00.000Z",
  "endDateTime": "2026-03-31T23:59:59.000Z",
  "totalCount": 42,
  "systemIds": [
    "a1b2c3d4-...",
    "e5f6a7b8-..."
  ]
}

Villutilvik

ChangeLog Write Guard

ChangeLog Write Guard er reitur í Cloud Events Setup (reitur 17) sem stjórnar hvaða reitir Data.Records.Set má skrifa í. Hefur ekki áhrif á lesunaðgerðir.

Virkjun varðar

Breyting í Blocked eða Via force krefst þess að BC-breytingaskráin sé virk:

trigger OnValidate()
begin
    if Rec."ChangeLog Write Guard" in [Blocked, "Via force"] then
        if not ChangeLogSetup.Get() or not ChangeLogSetup."Change Log Activated" then
            Error(ChangeLogNotEnabledErr);
end;

Notkun force framhjágöngu (Via force stilling eingöngu)

Feldu "force": true sem efsta-stigs lykil innan data JSON ásamt data-fylkinu:

{
  "specversion": "1.0",
  "type": "Data.Records.Set",
  "source": "MyApp v1.0",
  "subject": "Customer",
  "data": "{\"force\":true,\"data\":[{\"id\":\"...\",\"fields\":{\"Name\":\"Updated Name\"}}]}"
}

Kallari verður að hafa CE Force Access heimildasamstæðu (PermissionSet 65303).

© Origo – Cloud Events Base Extension