Enterprise ERP Integrations & Data Connectors
የቀጥታ የERP ዳታ አገናኞች፣ የ Odoo 19 _read_group ሞተር፣ የሞዴል ደህንነት ፈቃድ ዝርዝር እና አውቶማቲክ የክሮን ማመሳሰል።
1. Overview & Business Value#
ይህ አጠቃላይ የአሰራር መመሪያ በ SmartERP ውስጥ ለEnterprise ERP Integrations & Data Connectors የሚያስፈልጉትን የስርዓት አርክቴክቸር፣ የንግድ የስራ ፍሰቶች፣ የማዋቀሪያ መለኪያዎች እና የአፈጻጸም እርምጃዎችን በዝርዝር ያብራራል።


2. Prerequisites & Security Access Groups#
- የሚያስፈልጉ ሞጁሎች:
smarterp_balanced_scorecard, smarterp_strategy - የደህንነት ቡድኖች:
Strategy Officer(ቴክኒካል መለያ፦smarterp_balanced_scorecard.group_bsc_user)Strategy Director(ቴክኒካል መለያ፦smarterp_balanced_scorecard.group_bsc_manager)Executive Committee Member(ቴክኒካል መለያ፦smarterp_balanced_scorecard.group_bsc_executive)
- የማስተር ዳታ ጥገኝነቶች: ስትራቴጂካዊ ጭብጦች፣ 4 የBSC እይታዎች (Financial, Customer, Internal Process, Learning & Growth)፣ የድርጅት KPIs እና የሩብ አመት ምዘና ክፍለ ጊዜያት።
3. Step-by-Step Configuration & Execution#
Step 1: Navigating to the Module Interface#
- ወደ SmartERP ስርዓት በ
https://smarterp.et/odooይግቡ። - የዋናውን App Switcher (ከላይ በስተግራ ጥግ ያለውን ፍርግርግ አዶ) ይክፈቱ።
- የ Strategic Execution መተግበሪያ አዶን ይምረጡ።
- ከላይኛው የማውጫ አሞሌ ላይ Strategic Execution → Perspectives → Strategic Objectives / KPIs / Action Plans የሚለውን ይክፈቱ።
Step 2: Creating and Parameterizing Records#
- ከላይ በስተግራ የቁጥጥር ፓነል ውስጥ ያለውን New የሚለውን አዝራር ጠቅ ያድርጉ።
- በመዝገብ ፎርሙ ውስጥ ያሉትን ግዴታ መስኮች ይሙሉ፡
- የግብ / KPI ስም (ግዴታ): ትክክለኛ ስትራቴጂካዊ የውጤት መግለጫ
- እይታ (ግዴታ): ከተወሰነው ክብደት ጋር ከ 4 ቱ ሚዛናዊ እይታዎች አንዱ
- ክብደት (%) (ግዴታ): ለአጠቃላይ የእይታ ነጥብ አስተዋፅኦ የሚያደርግ የመቶኛ ድርሻ
- የዒላማ ዋጋ እና መነሻ (ግዴታ): ሊለካ የሚችል የቁጥር ግብ እና ታሪካዊ መነሻ ነጥብ
- እንደ አስፈላጊነቱ አማራጭ የአሰራር መለኪያዎችን እና አካባቢያዊ መለያዎችን ያዋቅሩ፡
- የስሌት ቀመር (አማራጭ): አውቶማቲክ የSQL መጠይቅ ወይም የሞጁል ሞዴል መለኪያ ማውጣት
- የተነሳሽነት መሪ (አማራጭ): ለውጤቱ ተጠያቂ የሆነ የመምሪያ ኃላፊ ወይም ከፍተኛ ስራ አስኪያጅ
- የግምገማ ድግግሞሽ (አማራጭ): ወርሃዊ፣ ሩብ አመታዊ ወይም አመታዊ የምዘና ዑደት
- መዝገቡን ለማስቀመጥ በመቆጣጠሪያ አሞሌው ውስጥ ያለውን Save አዶ ጠቅ ያድርጉ።
Step 3: Validating and Processing Transactions#
- የሁኔታ ሽግግሮች: የአሰራር ሁኔታ እድገትን ያከናውኑ (Draft → Active Target → Mid-Term Review → Final Appraisal → Locked)።
- የመዝገብ እና የስርዓት ተፅዕኖ: የፋይናንስ እይታ KPIs የጠቅላላ ሂሳብ መዝገብ ቀሪዎችን፣ የገቢ እድገት መለኪያዎችን እና የወጪ ጥምርታዎችን በቀጥታ ከሂሳብ አያያዝ ሞተር ያነባሉ።
- የኦዲት ማረጋገጫ: የፈጣሪ መለያ፣ የጊዜ ማህተም እና የማይለወጥ የክለሳ ታሪክ በራስ-ሰር መመዝገብ።
Odoo 19 Native Dynamic Aggregation Engine#
በቀደሙት Odoo 17 እና 18 ስሪቶች የሞዴሎች ስሌት ጊዜ ያለፈበትን read_group() ይጠቀም ነበር፣ ይህም በተጠየቀው ቀመር ምትክ የመስኩን ነባሪ ኦፕሬተር ሊጠቀም ይችላል።
BSC V3 የ Odoo 19 ኦሪጅናል _read_group() ኤፒአይን ይጠቀማል፡
# Native Odoo 19 Dynamic Aggregation Pipeline:
domain = safe_eval(kpi.source_domain or "[]")
# Automatically injects period calendar boundaries:
domain += [
(date_field, ">=", period.date_start),
(date_field, "<=", period.date_end),
]
# Executes dynamic aggregation query:
results = env[kpi.source_model_id.model]._read_group(
domain=domain,
aggregates=[f"{measure_field}:{aggregator}"], # e.g. "price_subtotal:sum"
)
actual_value = results[0][0] if results else 0.0
የሚደገፉ ማጠቃለያዎች የሚከተሉትን ያካትታሉ፡
sum: አጠቃላይ መጠን (ለምሳሌ ጠቅላላ የሽያጭ ገቢ፣ ጠቅላላ የጭነት ክብደት)።avg: አማካይ አፈጻጸም (ለምሳሌ አማካይ የደረሰኝ ሂደት ቆይታ፣ አማካይ የተግባር እርካታ)።count: የመዝገብ ብዛት (ለምሳሌ ያሸነፉ የድርጅት እድሎች ብዛት፣ ንቁ የተማሪዎች ምዝገባ)።min/max: የወሰን መለኪያዎች (ለምሳሌ ዝቅተኛ የSLA ዝግጁነት፣ ከፍተኛ የማስረከቢያ መዘግየት)።
Security Model: Positive Model Allowlist#
የKPI ሞተሩ በመረጃ ቋት ሠንጠረዦች ላይ መጠይቆችን ስለሚያከናውን ደህንነት እጅግ ወሳኝ ነው። በቀደሙት ረቂቆች ያልተገደቡ የ sudo() ፍለጋዎች ያልተፈቀደ ተጠቃሚ ሚስጥራዊ የደመወዝ ወይም የማረጋገጫ ሠንጠረዦችን እንዲጠይቅ ሊፈቅዱ ይችሉ ነበር።
BSC V3 ጥብቅ የፍቃድ ዝርዝርን ያስገድዳል (Strict Positive Allowlist & Deny Guard)፡
# Safe Model Security Allowlist:
ALLOWED_SOURCE_MODELS = {
"account.move", "account.move.line",
"sale.order", "sale.order.line",
"crm.lead",
"project.project", "project.task",
"hr.employee", "hr.department", "hr.leave",
"stock.picking", "stock.move",
"mrp.production",
"fleet.vehicle", "freight.booking",
"sacco.loan", "sacco.member",
}
DENIED_MODELS = {
"res.users", "res.company", "ir.model", "hr.payslip", "hr.contract"
}
አንድ አስተዳዳሪ ወይም ተጠቃሚ የKPI ምንጭ ሞዴልን ወደ ተከለከለ ወይም ፍቃድ ወደሌለው ሠንጠረዥ ለማመልከት ከሞከረ ስርዓቱ ማስቀመጥን ያግዳል እንዲሁም ግልጽ የደህንነት ማሳወቂያ ያሳያል፡
"Access Denied: The requested model is restricted from automated BSC KPI queries for data governance and privacy."
Standard SmartERP App Connectors#
1. Financial & Invoicing Integration (account.move.line)#
- KPI መለኪያዎች: ወርሃዊ ጠቅላላ ገቢ፣ የስራ ማስኬጃ ወጪዎች፣ አጠቃላይ የትርፍ ህዳግ %፣ የገንዘብ ገቢ ደረሰኞች።
- Filter Domain:
[('move_id.state', '=', 'posted'), ('account_id.account_type', '=', 'income')] - Measure Field:
credit - debit(ወይምbalance) - የቀጥታ ጥቅም: የሂሳብ ባለሙያው ደረሰኝ ባስመዘገበበት ቅጽበት ወርሃዊ የፋይናንስ ውጤቶች ኦዲት ከተደረጉ የጠቅላላ ሂሳብ መስመሮች በቀጥታ ይንጸባረቃሉ፣ ይህም የተመን ሉህ ድጋሚ ስሌቶችን ያስቀራል።
2. Commercial Sales & CRM (sale.order, crm.lead)#
- KPI መለኪያዎች: የተጣራ አዲስ አመታዊ ተደጋጋሚ ገቢ (ARR)፣ የማሸነፍ መጠን %፣ አማካይ የውል መጠን፣ የእርሳስ ፍጥነት።
- Filter Domain:
[('state', 'in', ['sale', 'done']), ('team_id.name', '=', 'Enterprise Sales')] - Measure Field:
amount_untaxedከsumአጠቃላይ ጋር።
3. Project Management & Engineering Delivery (project.task)#
- KPI መለኪያዎች: ስትራቴጂካዊ የምእራፍ ፍጥነት፣ የስፕሪንት ማቅረቢያ መጠን %፣ ክፍት ከፍተኛ ቅድሚያ የስህተት ብዛት።
- Filter Domain:
[('project_id.is_strategic', '=', True), ('state', '=', '1_done')] - Measure Field:
effective_hoursወይምcount።
4. Human Resources & Talent (hr.employee)#
- KPI መለኪያዎች: የሰራተኞች እድገት፣ በፈቃደኝነት መልቀቅ %፣ የስልጠና ማጠናቀቂያ መጠን።
- Filter Domain:
[('active', '=', True), ('department_id', '=', dept_id)] - Measure Field:
id:count።
5. Fleet & Logistics Operations (freight.booking, fleet.vehicle)#
- KPI መለኪያዎች: በሰዓቱ የማጓጓዣ ኮሪደር ማድረስ %፣ የሞጆ ደረቅ ወደብ ማጽጃ ፍጥነት፣ የከባድ መኪናዎች አጠቃቀም።
- Filter Domain:
[('stage', '=', 'delivered')]
Automated Data Synchronization Cron#
የKPI ዋጋዎች በእጅ የአዝራር ጠቅታዎችን አይፈልጉም። SmartERP BSC V3 ከሁለት አስቀድመው ከተዋቀሩ የጀርባ ክሮን ሰራተኞች ጋር ይላካል፡
- KPI Data Connector Sync (
ir.cron.bsc.kpi.fetch):- በየምሽቱ በ 00:00 ይሰራል::
- ሁሉንም ንቁ የውጤት ካርዶች ይቃኛል፣ የአሁኑን ያለፈ የቀን መቁጠሪያ ክፍለ ጊዜ ይለያል፣ የተዋቀረውን ጎራ በመጠቀም የቀጥታ ERP ሠንጠረዦችን ይጠይቃል፣ እና የ
actual_valueመስክን ያዘምናል።
- Red-KPI Escalation Monitor (
ir.cron.bsc.escalation):- አዲስ የተለኩ ክፍለ ጊዜዎችን ይገመግማል።
- ወሳኝ የሆነ KPI $< 70.0\%$ (ቀይ ዞን) ካስመዘገበ ስርዓቱ በተጠያቂው ስራ አስፈፃሚ ዳሽቦርድ ላይ አውቶማቲክ ተግባር ይፈጥራል እንዲሁም ተጠያቂውን ስራ አስኪያጅ የሚያሳውቅ የቻተር ማስጠንቀቂያ ይመዘግባል።
4. Advanced Configuration Points#
- አውቶማቲክ እርምጃዎች እና የታቀዱ ተግባራት (ክሮኖች):
BSC: Calculate quarterly KPI achievements(smarterp_bsc.ir_cron_compute_kpi): ጥምር የስኬት ውጤቶችን ለማስላት በየሩብ አመቱ በ5ኛው ቀን ይሰራልBSC: Issue appraisal cascade reminders(smarterp_bsc.ir_cron_appraisal_alert): ኃላፊዎች እድገታቸውን እንዲያዘምኑ ለማስታወስ በየወሩ ይሰራል
- ብጁ የህትመት አብነቶች እና ሪፖርቶች:
- የተቋማዊ ሚዛናዊ የውጤት ካርድ የስራ አመራር ዳሽቦርድ
- የመምሪያ ደረጃ ስትራቴጂክ የካስኬድ ማትሪክስ
- የKPI አፈጻጸም ልዩነት እና የአዝማሚያ ትንተና
- የድርጅት ስትራቴጂ አፈጻጸም ማጠቃለያ
- የበርካታ ኩባንያዎች ህጎች: በኩባንያ 1 (
Ashewa Technology Solutions S.C.) ስር የመዝገብ-ደረጃ የደህንነት መነጠል፣ በዋና እና በቅርንጫፍ ህጋዊ አካላት መካከል የሂሳብ መዝገብ መረጃ መፍሰስን ይከላከላል።
5. Comprehensive Troubleshooting Matrix#
| Error Symptom / Exception | Probable Root Cause | Corrective Action / Resolution |
|---|---|---|
Weighting Error: Perspective weights do not equal 100% | በእይታው ውስጥ ላሉ ግቦች የተመደቡ አጠቃላይ ክብደቶች ድምር 100.00% አልሞላም። | የእይታው አጠቃላይ ድምር በትክክል 100% እንዲሆን የግለሰብ ግብ ክብደቶችን ያስተካክሉ። |
Data Feed Error: Automated KPI metric returned null | መሰረታዊ የሞዴል መጠይቅ አልተሳካም ወይም የታለመው ዳታቤዝ እይታ ምንም መዝገብ የለውም። | በKPI አውቶማቲክ ስሌት መለኪያዎች ውስጥ የተገናኘውን የሞዴል ስም እና የማጣሪያ ጎራ ያረጋግጡ። |
Lockout Error: Period results locked for executive review | የአሁኑ የግምገማ ሩብ አመት በስትራቴጂ ዳይሬክተሩ ተቆልፏል። | የጽሁፍ ፈቃድ ያግኙ እና ከስትራቴጂ ዳይሬክተሩ ጊዜያዊ መክፈቻ ይጠይቁ። |