Cloud Events uppsetning — Tilvísunarhandbók

Yfirlit

Cloud Events uppsetningin veitir miðlæga stillingu fyrir val á útfærslustefnu fyrir ýmsar skilaboðategundir. Þetta skjal útskýrir hvernig á að stilla uppsetningartöfluna, velja útfærslur í gegnum enum-tæki og skilja viðmót-byggt skipulag.

Nafnrými: Origo.PTE.CloudEvents Uppsetningartafla: Cloud Events Setup (Tafla 65302) Uppsetningarsíða: Cloud Events Setup (Síða 65302)

Uppsetningarskipulag

Cloud Events-endingurinn notar viðmótsmiðað skipulag þar sem:

1. Viðmót skilgreina samninga sem útfærslur verða að fylgja
2. Enum-tæki bjóða upp á valmöguleika sem útfæra tiltekin viðmót
3. Uppsetningartafla geymir valdar enum-gildi fyrir hvert eiginleikasvæði
4. Skilaboðategundarútfærslur sækja valið viðmót úr uppsetningunni

Þetta hönnunarform leyfir:

• Stækkunarhæfni: Bættu við nýjum útfærslum með því að framlengja enum-tækið
• Sveigjanleika: Skipta um útfærslur án kóðabreytinga
• Aðskilnað áhyggna: Viðskiptaleg rök eru óháð útfærsluvalinu

Stillireitar

1. Lánstraustateynd viðskiptavinar

Reitur: Customer Credit Limit Type (Reitur 10) Tegund: Enum Customer Credit Limit Type (Enum 65303) Viðmót: Customer Credit Limit Tengd skilaboðategund: Customer.CreditLimit.Get

Tilgangur: Ákvarðar hvernig lánstraustaútreikningur viðskiptavinar er framkvæmdur.

Tiltæk gildi:

Stækkunarhæfni:

enumextension 50100 "My Credit Limit Type" extends "Customer Credit Limit Type"
{
    value(50100; "Enhanced Credit Check")
    {
        Caption = 'Enhanced Credit Check';
        Implementation = "Customer Credit Limit" = "My Credit Limit Impl";
    }
}

2. Þolinmæðihlutfall lánstraustmarks

Reitur: Credit Limit Tolerance % (Reitur 11) Tegund: Decimal Svið: 0 til 100

Tilgangur: Skilgreinir þolinmæðihlutfall við athugun á hvort lánstraustamark sé farið yfir. Þetta gildi bætir við sveigjanleika í lánstraustaframfylgni með því að leyfa hlutfallslegan búfa yfir lánstraustamarkið.

Hvernig það virkar:

1. Grunnútreikningur:

• Notað lán = Staða (SGM) + Útistandandi upphæð (SGM)
• Eftirstandandi lán = Lánstraustamark − Notað lán

1. Með þolinmæði:

• Þolinmæðiupphæð = Lánstraustamark × (Þolinmæðihlutfall ÷ 100)
• Eftirstandandi lán með þolinmæði = Eftirstandandi lán + Þolinmæðiupphæð
• Er farið yfir = (Eftirstandandi með þolinmæði < 0)

Tengdir svarreitir í Customer.CreditLimit.Get:

• remainingCredit: Reiknaðar án þolinmæðihlutfalls
• tolerancePercent: Stillt þolinmæðihlutfall
• remainingCreditWithTolerance: Reiknaðar með þolinmæðihlutfalli
• isCreditLimitExceeded: Boolean byggt á þolinmæðiútreikningi

3. Vörubirgðaútreikningartegund

Reitur: Item Calc. Availability Type (Reitur 12) Tegund: Enum Item Calc. Availability Type (Enum 65304) Viðmót: Item Calc. Availability Tengd skilaboðategund: Item.Availability.Get

Tilgangur: Ákvarðar hvernig vörugæðar eru reiknaðar.

Tiltæk gildi:

Raunbirgðir (Physical Inventory):

• Skilar raunverulegt Inventory reitargildi úr vörufjárhagsfærslum
• Einfaldur uppfræðslubyggður útreikningur
• Bestu nota þegar þú þarft núverandi á-hendi magn

Snið svars:

{
  "itemNo": "1000",
  "inventory": [
    { "locationCode": "BLUE", "inventory": 50 },
    { "locationCode": "RED", "inventory": 30 }
  ]
}

Reiknað magn (Calculated Quantity):

• Reiknar áætlað tiltækt magn byggt á:
• Núverandi birgðum
• Frátengdum magni (til og mið requested-delivery-date)
• Heildareftirspurn úr sölupöntunum, þjónustupöntunum, verkum, framleiðslu, samsetningum
• Áætlaðar móttökur úr innkaupapöntunum, framleiðslu, samsetningum, flutningum
• Áætlaðar pantanir úr beiðniskilagjörðum og áætlaðri framleiðslu

Snið svars:

{
  "itemNo": "1000",
  "availability": [
    {
      "locationCode": "BLUE",
      "inventory": 50,
      "qtyReserved": 10,
      "grossRequirement": 20,
      "scheduledReceipt": 30,
      "plannedOrderReceipt": 15,
      "availableQuantity": 65
    }
  ]
}

4. Vöruverðútreikningartegund

Reitur: Item Price Calculation Type (Reitur 13) Tegund: Enum Item Price Calculation Type (Enum 65305) Viðmót: Item Price Calculation Tengd skilaboðategund: Item.Price.Get

Tilgangur: Ákvarðar hvernig verðupplýsingar vöru eru sóttar.

Tiltæk gildi:

Verðvalrök (Priority order):

1. Viðskiptavin-sértækt verð (ef customerNo er gefið)
2. Almennt verð (allir viðskiptavinir)
3. Verð af birgðarspjaldi (ef engar verðlistalínur finnast)

5. Sjálfgefinn tungumálakóði

Reitur: Default Language Code (Reitur 14) Tegund: Code[10] Tengdar skilaboðategundir: Help.Tables.Get, Help.Fields.Get og allar sem skila tungumálstengdum birtiheitum

Tilgangur: Tilgreinir sjálfgefið tungumál þegar lcid er ekki tilgreint í CloudEvents skilaboðum.

Tvær-stigsaðferð:

1. Aðalleiðin: lcid í CloudEvents skilaboðum

• lcid reiturinn er tilgreindur á skilaboðastigi (ekki í data)
• Þegar gefið, hefur forgang yfir Default Language Code

1. Varamöguleiki: Default Language Code

• Notaður þegar lcid er ekki tilgreint í skilaboðum
• Ef ekki stilltur eða Language-færsla finnst ekki, er sjálfgefið 1033 (Enska — Bandaríkin)

Algengir tungumálakóðar:

Dæmi um notkun:

Beiðni án lcid → Default Language Code notað:

{ "type": "Help.Tables.Get", "data": {} }

Beiðni með lcid → Þetta þriggur yfir Default Language Code:

{ "type": "Help.Tables.Get", "lcid": 1033, "data": {} }

6. Reikningstegundarúlfur viðskiptavinar

Reitur: Customer Statement Type (Reitur 15) Tegund: Enum Customer Statement Type (Enum 65306) Viðmót: Customer Statement Tengd skilaboðategund: Customer.Statement.Pdf

Tilgangur: Ákvarðar hvaða útfærsla er notuð til að búa til PDF-reikninga viðskiptavinar.

Tiltæk útfærslur:

Sjálfgefið gildi: Standard Statement (gildi 0).

7. ChangeLog-skrifjörn

Reitur: ChangeLog Write Guard (Reitur 17) Tegund: Enum ChangeLog Write Guard Type (Enum 65308) Viðmót: ChangeLog Write Guard Tengdar skilaboðategundir: Data.Records.Set, ChangeLog.Field.Restore

Tilgangur: Stýrir hvaða reiti Data.Records.Set má skrifa í. Þegar virk, kannast verndin hvert markreit á móti BC Change Log uppsetningunni áður en skrif er framkvæmt.

Tiltæk gildi:

**Nota force sniðgang (aðeins Via force stillingu):**

{
  "specversion": "1.0",
  "type": "Data.Records.Set",
  "subject": "Customer",
  "data": "{\"force\":true,\"data\":[{\"id\":\"...\",\"fields\":{\"Name\":\"Nýtt nafn\"}}]}"
}

Athugasemdir:

• Breyting á verndinni í Blocked eða Via force krefst þess að BC Change Log eiginleikinn sé virkur
• Notaðu ChangeLog.Field.Enabled til að athuga reitarþekju áður en skrift er reynd
• Án CE Force Access heimildarsetts er beiðninni hafnað jafnvel með force: true

8. Tegund útflutnings á heiti fyrirtækis

Reitur: Export Company Name Type (Reitur 18) Tegund: Enum Cloud Event Company Name Type (Enum 65601) Viðmót: Cloud Event Company Name Tengdar skilaboðategundir: CSV.Records.Get, CSV.DeletedRecords.Get

Tilgangur: Velur hvaða heiti fyrirtækis er skrifað í $Company dálkinn í CSV-útflutningum. Reiturinn stýrir einum, kerfisúkekkilegum vali sem báðir CSV-útflutningar leysa einu sinni á beiðni (svo allar línur í sama útflutningi nota sama gildi).

Tiltæk gildi:

Hvenær á að nota hvert gildi:

• Heiti fyrirtækis — móttökukerfi sem nota heitið sem auðkenni (skipting í gagnavatni, Open Mirroring lendingarsvæði, bc2adls). Endurnefningar á birtingarheiti mega ekki breyta skiptingarlykli.
• Birtingarheiti fyrirtækis — CSV-notendur sem eru manneskjur (rekstrarskýrslur, könnun). Birtingarheiti er notendavænna og samsvarar því sem sjást í BC.

Lausn:

var
    CloudEventsSetup: Record "Cloud Events Setup";
    ExportCompanyName: Text[250];
begin
    ExportCompanyName := CloudEventsSetup.GetExportCompanyName();
end;

Báðar CSV-útfærslurnar kalla á GetExportCompanyName() einu sinni á beiðni og endurnota gildið fyrir hverja línu í $Company dálknum.

Stækkanleiki:

enumextension 50104 "My Company Name Type" extends "Cloud Event Company Name Type"
{
    value(50100; "Legal Name")
    {
        Caption = 'Legal Name';
        Implementation = "Cloud Event Company Name" = "My Legal Name Impl";
    }
}

Uppsetningaraðgerðir

GetRecordOnce()

Tilgangur: Tryggir að uppsetningarfærslan sé aðeins hlaðin einu sinni á hverja færslu.

Hegðun:

• Kannar hvort færslan hafi þegar verið lesin í þessari keyrslu
• Ef ekki, reynir að sækja færsluna
• Ef færsla er ekki til, stofnar hana með sjálfgefnum gildum
• Stillir RecordHasBeenRead fána til að koma í veg fyrir endurteknar lesningar

Notkun:

CloudEventsSetup.GetRecordOnce();

InsertIfNotExists()

Tilgangur: Stofnar uppsetningarfærslu ef hún er ekki til.

Notkun:

CloudEventsSetup.InsertIfNotExists();

GetCustomerCreditLimitInterface()

Tilgangur: Sækir valda lánstraustautfærslu viðskiptavinar.

Skilar: Viðmót Customer Credit Limit

Notkun:

var
    CreditLimitInterface: Interface "Customer Credit Limit";
    CloudEventsSetup: Record "Cloud Events Setup";
begin
    CreditLimitInterface := CloudEventsSetup.GetCustomerCreditLimitInterface();
    CreditLimitInterface.CheckCreditLimit(Argument);
end;

GetItemCalculateAvailabilityInterface()

Tilgangur: Sækir valda vörubirgðaútreikningsutfærslu.

Skilar: Viðmót Item Calc. Availability

Notkun:

var
    AvailabilityInterface: Interface "Item Calc. Availability";
    CloudEventsSetup: Record "Cloud Events Setup";
begin
    AvailabilityInterface := CloudEventsSetup.GetItemCalculateAvailabilityInterface();
    AvailabilityInterface.CalculateAvailability(Argument);
end;

GetItemPriceCalculationInterface()

Tilgangur: Sækir valda vöruverðreikningsutfærslu.

Skilar: Viðmót Item Price Calculation

Notkun:

var
    PriceInterface: Interface "Item Price Calculation";
    CloudEventsSetup: Record "Cloud Events Setup";
begin
    PriceInterface := CloudEventsSetup.GetItemPriceCalculationInterface();
    PriceInterface.CalculateItemPrice(Argument);
end;

GetCustomerStatementInterface()

Tilgangur: Sækir valda reikningsútfærslu viðskiptavinar.

Skilar: Viðmót Customer Statement

Notkun:

var
    StatementInterface: Interface "Customer Statement";
    CloudEventsSetup: Record "Cloud Events Setup";
begin
    StatementInterface := CloudEventsSetup.GetCustomerStatementInterface();
    StatementInterface.GetCustomerStatement(Argument);
end;

GetCompanyNameInterface()

Tilgangur: Sækir valda útfærslu Cloud Event Company Name.

Skilar: Viðmót Cloud Event Company Name

Hegðun:

1. Hleður aðeins Export Company Name Type reitnum (snöggt)
2. Kallar á GetRecordOnce() til að tryggja að uppsetningarfærslan sé til
3. Skilar enum-gildinu sem viðmóti

Notkun:

var
    CompanyNameInterface: Interface "Cloud Event Company Name";
    CloudEventsSetup: Record "Cloud Events Setup";
begin
    CompanyNameInterface := CloudEventsSetup.GetCompanyNameInterface();
end;

GetExportCompanyName()

Tilgangur: Þegægileg vafning sem leysir valið útfærslu og skilar heiti fyrirtækis fyrir $Company dálkinn.

Skilar: Text[250]

Hegðun:

1. Kallar á GetCompanyNameInterface() til að fá valið útfærslu
2. Kallar á GetCompanyName() á þeirri útfærslu
3. Skilar textanum (aldrei autt — Display Name útfærslan fellur til baka á CompanyName())

Notkun:

var
    CloudEventsSetup: Record "Cloud Events Setup";
    ExportCompanyName: Text[250];
begin
    ExportCompanyName := CloudEventsSetup.GetExportCompanyName();
end;

Kallarar eiga að leysa þetta einu sinni á beiðni og endurnota gildið fyrir hverja línu í sömu útflutningi.

Viðmótsarkitektúr

Mynstur viðmótsskilgreiningar

Hvert eiginleikasvæði skilgreinir viðmót sem allar útfærslur verða að fylgja:

interface "Item Calc. Availability"
{
    procedure CalculateAvailability(var Argument: Record "Cloud Event Message Argument")
}

Mynstur enum-útfærslu

Enum-tæki útfæra viðmótið og tilgreina hvaða kóðaeining veitir útfærsluna:

enum 65304 "Item Calc. Availability Type" implements "Item Calc. Availability"
{
    Extensible = true;
    DefaultImplementation = "Item Calc. Availability" = "Physical Inventory Impl";

    value(0; "Physical Inventory")
    {
        Caption = 'Physical Inventory';
        Implementation = "Item Calc. Availability" = "Physical Inventory Impl";
    }
    value(1; "Calculated Quantity")
    {
        Caption = 'Calculated Quantity';
        Implementation = "Item Calc. Availability" = "Calculated Quantity Impl";
    }
}

Heimildarsett

Cloud Events viðbótin inniheldur nokkur heimildarsett sem stýra aðgangi að ákveðnum eiginleikum.

CE Approval Access

Auðkenni heimildarsetts: 65306 Heiti: CE Approval Access Úthlutanlegt: Já

Tilgangur: Stýrir hvaða notendur mega senda skjöl til samþykktar í gegnum Document.Approval.Send skilaboðategundina. Notandi sem er ekki með þetta heimildarsett fær villusvar þegar kallað er á Document.Approval.Send.

Villa þegar vantar:

User <UserSecurityId> does not have permissions to send documents to approval via Cloud Events.

Hvernig það virkar: Heimildarsettið veitir skrifheimild á gátatöflu Cloud Events Approval Access (65314). Útfærslan kannar WritePermission() á þeirri töflu áður en beiðni er unnin — engar færslur eru geymdar í töflunni.

Úthlutun: Úthlutið í gegnum venjulega BC Heimildarsett síðu eða í gegnum notendaflokk.

CE Force Access

Tilgangur: Nauðsynlegt til að fara framhjá ChangeLog Write Guard þegar "force": true er notað í Data.Records.Set beiðnum þar sem verndin er stillt á Via force. Sjá ChangeLog Write Guard fyrir nánari upplýsingar.

Bókunarhlið (CE G/L / Item / FA / Job / Resource / Warehouse Posting)

Allar *.Post og *.Reverse skilaboðategundir sem skrifa færslur í höfuðbækur eru með hlið per bókunarsviði. Notandi sem ekki hefur viðeigandi heimildarsett fær villuskil án nokkurra hliðaráhrifa:

Posting denied: missing 'CE <Domain> Posting' permission set.

Heimildarsettin sex eru sjálfstæð og **eru ekki innifalin í CE Read eða CE Full** — þeim verður að úthluta sérstaklega. Hvert veitir RIMD á tóma stoðtöflu (65323–65328) sem öryggiskjarni BC notar fyrir WritePermission() athugun; engar færslur eru geymdar.

Athugið: Sales.Document.Post og Purchase.Document.Post eru gættar af G/L eingöngu þrátt fyrir að þær geti búið til vöru- og aðrar færslur í framhaldinu. Hliðið endurspeglar áform notandans um að ræsa bókun, ekki færslurnar sem BC skrifar að lokum. Warehouse.Shipment.Post með invoice = true er eina aðgerðin sem krefst tveggja heimildarsetta samtímis.

Athugunin liggur í codeunit Cloud Events Posting Gate (65600). Til að bæta við sviði bætið gildi í enum Cloud Events Posting Type (65324) ásamt samsvarandi gátatöflu og heimildarsetti.

Tengd skjöl

• API_Reference.md: API-endapunktar og auðkenning
• Sales_Message_Types.md: Sölu- og viðskiptalegar skilaboðategundir (notar uppsetningarviðmót)
• ChangeLog_Message_Types.md: ChangeLog.Field.Restore og ChangeLog.Field.Enabled

© Origo – Cloud Events Base Extension