Reitaðgangstakmörk

Cloud Events API styður hæfnina að takmarka API-aðgang á reitastigsstigi. Reitir geta verið lokaðir fyrir lestur, skrif eða hvort tveggja í gegnum stillingarborðið — án þess að breyta neinum AL-kóða.

Takmörkunartegundir

Hegðun við lestur (Data.Records.Get, CSV.Records.Get)

Reitir með Read eða Both tegund eru þegjandi slepptir frá útgangi: enginn villudagar, reiturinn birtist einfaldlega ekki í JSON-svaritöflum. Þetta tryggir bakwardstengda samhæfni.

Hegðun við skrif (Data.Records.Set)

Ef kallari reynir að skrifa í reit sem er lokaður með Write eða Both tegund, skilar API villu með skýru skilaboði: "Field 'FieldName' is write-restricted in table 'TableName'." Skrifun fer ekki fram þrátt fyrir villu — örar breytingar á öðrum reitum í sömu beiðni eru framkvæmdar áður en villan kemur upp.

Algildisreglur (wildcards)

Kerfið styður tvö algildisgildi til að setja takmarkanir á breiðum grundvelli án þess að búa til færslur fyrir hvern reit eða hverja töflu:

Uppflettingarröð (fallback-keðja)

Þegar athugað er hvort reitur sé takmarkaður, metur kerfið færslur í þessari röð:

1. Nákvæm færsla — Notandi + Tafla + Reitur
2. Allir reitir — Notandi + Tafla + Svæðisnúmer = 0
3. Allar töflur — Notandi + Töflunúmer = 0 + Svæðisnúmer = 0

Fyrsta samsvörun gildir. Ef engin færsla finnst á neinu stigi er reiturinn ótakmarkaður.

Staðfestingarreglur

• Þegar Töflunúmer er sett á 0 er Svæðisnúmer sjálfkrafa sett á 0 og heiti reits sýnir <Öll svæði>
• Reynsla á að setja Svæðisnúmer á annað gildi en 0 þegar Töflunúmer = 0 skapar villu: „Svæðisnúmer verður að vera 0 þegar töflunúmer er 0 (allar töflur)."
• Uppfletting á svæðisnúmeri er óvirk þegar Töflunúmer = 0

Dæmi

Uppsetning reitaðgangstakmarka

Leið í BC

Valmynd → Þjónusta → Cloud Events → Reitaðgangstakmörk (Field Access Restrictions)

Útlit síðu

Stillingarsíðan sýnir þrjár dálkar:

• Tafla — nafn töflunnar
• Reitur — nafn reitsins sem takmarkaður er
• Tegund — Both, Read, Write eða Bypass

Auk þess er hægt að takmarkaðara notkun:

• Notandi — (All Users) eða ákveðinn nafn BC-notanda

Þegar (All Users) er valinn á tegund Both, Read eða Write, gildir takmörkun um alla API-kallara nema þeir sem hafa sérstaka Bypass-færslu stillt fyrir sig.

Bæta við takmörkun

1. Opnaðu Reitaðgangstakmörk síðuna.
2. Veldu eða sláðu inn heiti Töflu (t.d. Customer).
3. Veldu Reit í þeirri töflu (t.d. Credit Limit (LCY)).
4. Veldu Tegund: Both, Read, Write eða Bypass.
5. Valfrjálst: Veldu ákveðinn Notanda til að beita einungis á þann notanda.
6. Vistaðu.

Athugið: Þegar BC útfærsla er með Azure AD auðkenningu (service principal) er auðkennirinn settur út sem ENTRA/{clientId} útlit. AAD-notendur eru ekki með BC-notendanöfn, svo notendatengdar takmarkanir eiga aðeins við um gagnaðgenga BC-notendur, ekki API-þjónustur.

Dæmi um notkun

Loka lestur á viðkvæmum fjárhagsreitum:

Undanskilja tiltekinn samþættingarnotanda:

Í þessu dæmi geta allir notendur/API-þjónustur ekki lesið né skrifað Credit Limit (LCY), nema SVC_INT_USR-notandinn sem fær fullan aðgang.

API-tilvísun

Tafla 65304 — Cloud Events Field Access

Kóðaeining 65350 — Cloud Events Field Access Mgt

Þessi kóðaeining útfærir athuganarrök fyrir reitaðgangstakmörk.

Opinberar aðferðir:

/// <summary>
/// Athugar hvort reitur sé lokaður frá lestur fyrir gefinn notanda.
/// </summary>
procedure IsReadRestricted(TableNo: Integer; FieldNo: Integer; UserName: Code[50]): Boolean

/// <summary>
/// Athugar hvort reitur sé lokaður frá skrifum fyrir gefinn notanda.
/// </summary>
procedure IsWriteRestricted(TableNo: Integer; FieldNo: Integer; UserName: Code[50]): Boolean

/// <summary>
/// Skilar lista yfir alla takmarkaða reiti í töflu fyrir gefinn notanda.
/// </summary>
procedure GetRestrictedFields(TableNo: Integer; UserName: Code[50]; var CloudEventsFieldAccess: Record "CE Field Access")

Þróunarsnotkun

Reitaðgangstakmörk eru framfylgt sjálfkrafa af Data.Records.Get og Data.Records.Set meðhöndlun skilaboðategunda. Þú þarft ekki að kalla á Cloud Events Field Access Mgt kóðaeininguna beint nema þú sért að smíða eigin viðbætur ofan á Cloud Events grunninn.

Ef þú vilt athuga hvort ákveðinn reitur sé lokaður í kóða:

var
    CloudEventsFieldAccessMgt: Codeunit "CE Field Access Mgt";
begin
    if CloudEventsFieldAccessMgt.IsWriteRestricted(Database::Customer, 21, UserId()) then
        Error('Reitur er lokaður frá skrifum.');
end;

Þekktar takmarkanir

• Reitaðgangstakmörk gilda einungis um Cloud Events API-aðgerðir. Þær takmarka ekki bein BC-UI aðgerðir, REST API-kall eða önnur API-lag.
• BLOB-reitar og Media-reitar eru sjálfkrafa undanskildir Cloud Events API; reitatakmörk eru ekki nauðsynleg fyrir þær tegundir.
• Þegar reitur hefur bæði (All Users) takmörkun og Bypass-færslu fyrir ákveðinn notanda, þá fær Bypass-notandinn alltaf fullan aðgang.

© Origo – Cloud Events Base Extension