يضيف برنامج Apps Script صغير معادلتين إلى Google Sheets: =NAARVIN لرقم واحد و=NAARVIN_SERIES لرقم لكل شهر. وتقرآن بنود قائمة الدخل والنقد والذمم المدينة والدائنة ورأس المال العامل من نارفن مباشرة، بمفتاح واجهة برمجية لا يرى إلا ما يسمح به دوره وشركاته. والقيم هي ما يحسبه نارفن تمامًا، بعملة التقارير لديك.
ما المعادلات التي يضيفها؟
| المعادلة | ما تعيده |
|---|---|
| =NAARVIN("EBITDA", "2026-06") | الأرباح قبل الفوائد والضرائب والإهلاك والاستهلاك لشهر يونيو 2026 |
| =NAARVIN("REV", "2026-Q2") | إيرادات الربع، وتعمل أيضًا ytd ومدى تواريخ مثل 2026-01-01..2026-06-30 |
| =NAARVIN("CASH", A1) | النقد في نهاية الشهر المذكور في الخلية A1، وخلية التاريخ تُحسب بشهرها |
| =NAARVIN("AR", "2026-06", "entities:<id>") | الذمم المدينة لشركة واحدة، وgroup:<id> تسمّي مجموعة |
| =NAARVIN_SERIES("REV", "2026-01", "2026-12") | رقم لكل شهر في عمود، حتى 36 شهرًا |
كل رمز بند في قائمة الدخل الإدارية لديك، مثل REV وGP وEBITDA وNI، مجموع على الفترة. أما CASH وAR وAP وWC فأرصدة في نهاية الفترة. ويعرض خيار «Metrics and scopes» في قائمة Naarvin ما يستطيع مفتاحك استخدامه بالضبط.
هل يمكن الوثوق بالأرقام في الجدول؟
هي أرقام المحرك نفسه، لا تُعاد حسابها في الجدول: المجاميع نفسها التي تعرضها قائمة الدخل والميزانية في نارفن، بعملة التقارير في منشأتك، والتكاليف موجبة كما في قائمة الدخل. والأشهر التي تلي آخر بيانات تُترك فارغة في السلسلة، ولا تظهر صفرًا أبدًا.
وحين لا يستطيع نارفن إعطاء رقم، تُظهر الخلية خطأ وتشرح ملاحظتها السبب، مثل «#NAARVIN: no access to cash» أو «#NAARVIN: unknown metric EBITDAX». وهو خطأ لا نص، فلا تتخطاه دالة SUM على العمود بصمت. ويُرفض الرقم أيضًا حين ينقص سعر صرف، لأنه سيكون ناقصًا.
وتُحفظ الإجابات خمس دقائق، ويعيد Google Sheets حساب المعادلة حين تتغير مدخلاتها أو يُعاد فتح الجدول. ويستطيع الجدول طلب 120 رقمًا في الدقيقة كحد أقصى.
ماذا يرى المفتاح؟
لا يرى إلا ما يسمح به دوره وشركاته. فالمفتاح حساب خدمة بدور واحد والشركات التي تختارها. ويحتاج كل مؤشر أيضًا إلى الصلاحية التي تعرضه في لوحة المؤشرات: قائمة الدخل أو النقد أو الذمم المدينة أو الدائنة أو الميزانية. فالمفتاح المعدّ لجدول كيان سعودي لا يستطيع قراءة المجموعة. اطلع على الواجهة البرمجية وWebhooks لمعرفة كيف تُنشأ المفاتيح وتُقيَّد.
ويُحفظ المفتاح في خصائص المستخدم للبرنامج: لك وحدك، ولا يُحفظ في الجدول، ولا يُكتب في أي سجل. ومشاركة الجدول لا تشارك المفتاح.
كيف تُعدّه؟
- أنشئ مفتاح واجهة برمجيةفي نارفن، من الإعدادات ثم التكاملات والواجهة البرمجية، ينشئ من يدير التكاملات مفتاحًا بالدور والشركات التي يحتاجها الجدول.
- أضف البرنامجنزّل برنامج Apps Script من الصفحة نفسها. وفي الجدول افتح Extensions ثم Apps Script، واستبدل محتوى المحرر به واحفظ.
- اربطأعد تحميل الجدول. ومن قائمة Naarvin الجديدة اختر Connect، وأدخل عنوان منشأتك والمفتاح، واسمح للبرنامج حين يطلب Google ذلك.
- اكتب معادلتك الأولىاكتب =NAARVIN("REV", "ytd") وقارنها بقائمة الدخل في نارفن.
أسئلة شائعة
هل مشاركة الجدول تشارك صلاحياتنا؟
لا. المفتاح في خصائص البرنامج الخاصة بك، لا في الجدول. ومن يفتح الجدول غيرك يحتاج إلى مفتاحه ليحدّث الأرقام.
هل تستطيع المعادلة تغيير شيء في نارفن؟
لا. المعادلات تقرأ الأرقام فقط.
هل يوجد مثله لبرنامج Excel؟
نعم. تعطي إضافة Excel المعادلتين NAARVIN.VALUE وNAARVIN.SERIES، وتُقرآن بمفتاح واجهة برمجية بالطريقة نفسها. اطلع على [Excel وCSV](/integrations/excel-and-csv).