> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kayanos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# دوال مقاييس التخطيط والموارد والمرونة

> مقاييس التخطيط للموارد والمخاطر والمرونة والملاحظات والحوادث والإجماليات المبنية من بيانات العلاقات العكسية.

## متى تستخدم هذه الدوال؟

تلخص هذه الدوال العلاقات العكسية المهيأة. قد تعيد العلاقة الفارغة أو غير المهيأة صفراً أو null أو ملخصاً فارغاً؛ فلا تعامل ذلك كدليل على عدم وجود عمل.

## طريقة الكتابة

استخدم الدالة بصيغة `planningOpenRiskCount($inverseRelations)`. لا تكون كل دالة متاحة في كل مكان: دوال التحقق ودوال النموذج ودوال قالب المستند لها عقود سياق مختلفة. لا تفترض أن اقتراح المحرر يعني أن الدالة مدعومة وقت التشغيل.

## مرجع الدوال الكامل

### `planningActiveIncidentCount`

يعد سجلات الحوادث النشطة.

**التوقيع:** `planningActiveIncidentCount(inverseRelations)`

**مثال:**

```txt theme={null}
planningActiveIncidentCount($inverseRelations)
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningActiveIncidentCount(...)`.

### `planningBiaCompletionPercent`

يعيد نسبة اكتمال تحليل أثر الأعمال.

**التوقيع:** `planningBiaCompletionPercent(inverseRelations)`

**مثال:**

```txt theme={null}
planningBiaCompletionPercent($inverseRelations)
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningBiaCompletionPercent(...)`.

### `planningBlockedDependencyCount`

يعد التبعيات التي حالتها معطلة أو معرضة للخطر.

**التوقيع:** `planningBlockedDependencyCount(inverseRelations)`

**مثال:**

```txt theme={null}
planningBlockedDependencyCount($inverseRelations)
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningBlockedDependencyCount(...)`.

### `planningControlCoveragePercent`

يعيد نسبة تغطية الضوابط.

**التوقيع:** `planningControlCoveragePercent(inverseRelations)`

**مثال:**

```txt theme={null}
planningControlCoveragePercent($inverseRelations)
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningControlCoveragePercent(...)`.

### `planningExercisePassRatePercent`

يعيد نسبة نجاح التمارين.

**التوقيع:** `planningExercisePassRatePercent(inverseRelations)`

**مثال:**

```txt theme={null}
planningExercisePassRatePercent($inverseRelations)
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningExercisePassRatePercent(...)`.

### `planningOpenFindingCount`

يعد ملاحظات التخطيط التي لم تصل حالتها إلى مغلق.

**التوقيع:** `planningOpenFindingCount(inverseRelations)`

**مثال:**

```txt theme={null}
planningOpenFindingCount($inverseRelations)
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningOpenFindingCount(...)`.

### `planningOpenRiskCount`

يعد مخاطر التخطيط التي لم تصل حالتها إلى مغلق.

**التوقيع:** `planningOpenRiskCount(inverseRelations)`

**مثال:**

```txt theme={null}
planningOpenRiskCount($inverseRelations)
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningOpenRiskCount(...)`.

### `planningProcedureReadinessPercent`

يعيد نسبة جاهزية الإجراءات.

**التوقيع:** `planningProcedureReadinessPercent(inverseRelations)`

**مثال:**

```txt theme={null}
planningProcedureReadinessPercent($inverseRelations)
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningProcedureReadinessPercent(...)`.

### `planningResourceCapacityUtilizationPercent`

يعيد الجهد مقسوماً على السعة كنسبة مئوية، أو `null` عند غياب السعة.

**التوقيع:** `planningResourceCapacityUtilizationPercent(inverseRelations, allocationSemantics?)`

**مثال:**

```txt theme={null}
planningResourceCapacityUtilizationPercent($inverseRelations, "actual")
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningResourceCapacityUtilizationPercent(...)`.

### `planningResourceCostSummary`

يعيد ملخصاً نصياً مجمعاً لتكاليف الموارد حسب العملة.

**التوقيع:** `planningResourceCostSummary(inverseRelations, allocationSemantics?)`

**مثال:**

```txt theme={null}
planningResourceCostSummary($inverseRelations, "planned")
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningResourceCostSummary(...)`.

### `planningResourceEffortHoursSummary`

يجمع ساعات الجهد لتخصيصات الموارد المطابقة في التخطيط.

**التوقيع:** `planningResourceEffortHoursSummary(inverseRelations, allocationSemantics?)`

**مثال:**

```txt theme={null}
planningResourceEffortHoursSummary($inverseRelations, "planned")
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningResourceEffortHoursSummary(...)`.

### `planningResourceNumericSummary`

يجمع حقلاً رقمياً محدداً للموارد عبر التخصيصات المطابقة.

**التوقيع:** `planningResourceNumericSummary(inverseRelations, fieldKey, allocationSemantics?)`

**مثال:**

```txt theme={null}
planningResourceNumericSummary($inverseRelations, "cost_amount", "actual")
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningResourceNumericSummary(...)`.

### `planningResourceQuantitySummary`

يعيد ملخصاً نصياً مجمعاً لكميات الموارد حسب الوحدة أو النوع.

**التوقيع:** `planningResourceQuantitySummary(inverseRelations, allocationSemantics?)`

**مثال:**

```txt theme={null}
planningResourceQuantitySummary($inverseRelations, "planned")
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningResourceQuantitySummary(...)`.

### `planningResourceVarianceAmount`

يعيد فرق قيمة المورد الفعلية ناقص المخططة.

**التوقيع:** `planningResourceVarianceAmount(inverseRelations, fieldKey, plannedSemantics = "planned", actualSemantics = "actual")`

**مثال:**

```txt theme={null}
planningResourceVarianceAmount($inverseRelations, "cost_amount")
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningResourceVarianceAmount(...)`.

### `planningRiskInherentExposureTotal`

يجمع درجات التعرض الكامن للمخاطر.

**التوقيع:** `planningRiskInherentExposureTotal(inverseRelations)`

**مثال:**

```txt theme={null}
planningRiskInherentExposureTotal($inverseRelations)
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningRiskInherentExposureTotal(...)`.

### `planningRiskMitigationCoveragePercent`

يعيد نسبة المخاطر التي لها إشارة معالجة، أو `null` عندما لا توجد سجلات مخاطر.

**التوقيع:** `planningRiskMitigationCoveragePercent(inverseRelations)`

**مثال:**

```txt theme={null}
planningRiskMitigationCoveragePercent($inverseRelations)
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningRiskMitigationCoveragePercent(...)`.

### `planningRiskResidualExposureTotal`

يجمع درجات التعرض المتبقي للمخاطر.

**التوقيع:** `planningRiskResidualExposureTotal(inverseRelations)`

**مثال:**

```txt theme={null}
planningRiskResidualExposureTotal($inverseRelations)
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningRiskResidualExposureTotal(...)`.

### `planningScenarioCoveragePercent`

يعيد نسبة تغطية جاهزية السيناريوهات.

**التوقيع:** `planningScenarioCoveragePercent(inverseRelations)`

**مثال:**

```txt theme={null}
planningScenarioCoveragePercent($inverseRelations)
```

**التوافر:** متاحة مع العلاقات العكسية المهيأة للتخطيط فقط. قد تعيد العلاقات الفارغة أو غير المهيأة صفراً أو `null` أو ملخصاً فارغاً.

**ملاحظة:** يمكن أيضاً كتابتها كتحويل عندما تكون القيمة الأولى هي المدخل: `value | planningScenarioCoveragePercent(...)`.

## قائمة تحقق قبل النشر

* ابدأ بقيمة معروفة وتحقق من النتيجة المتوقعة.
* تعامل صراحةً مع القيم الفارغة وnull والقوائم الفارغة.
* لا تضع أسراراً أو رموز وصول أو بيانات شخصية حساسة داخل تعبير.
* راجع [سياقات وتوافر التعبيرات](/ar/reference/expressions/contexts) قبل نسخ تعبير بين ميزتين.

![دوال مقاييس التخطيط والموارد والمرونة في KayanOS](https://kayanos.app/docs-images/ar/reference/expressions-helpers-planning-metrics.png)