Okta Partners

تعديل قالب ألّفه تطبيقك

PATCH https://getokta.io/api/apps/reports/templates/{id}

تعديل قالب ألّفه تطبيقك (يُسقط الاعتماد).

  • حدّ المعدّل: MODERATE
    مدى استهلاك هذا الطلب لحصتك: LIGHT أخف من MODERATE ثم HEAVY.
  • النطاق المطلوب: reports.builder.write
    النطاق (scope) الذي يجب أن يمنحه المستأجر لتطبيقك حتى يُسمح بهذا الطلب.
  • الرمز المرجعي: srv_1937
    مُعرّف ثابت لهذا الـ endpoint — اذكره عند مراسلة الدعم لتسريع التتبّع.

مُعطيات المسار

id string مطلوب

مُعرّف القالب المبهم كما وصلك من السرد — ليس رقماً.

مُعطيات الجسم

name_ar string

اسم القالب بالعربية.

name_en string

اسم القالب بالإنجليزية.

description string

وصف يراه من يختار القالب.

type enum

administrative | general.

orientation enum

portrait | landscape.

paper_size enum

a4 | a3 | letter.

header_enabled boolean

إظهار شريط الترويسة.

footer_enabled boolean

إظهار شريط التذييل.

header_right_content string

محتوى خانة الترويسة اليمنى — نصّ يقبل {{المتغيّرات}}.

header_center_content string

محتوى خانة الترويسة الوسطى.

header_left_content string

محتوى خانة الترويسة اليسرى.

footer_right_content string

محتوى خانة التذييل اليمنى.

footer_center_content string

محتوى خانة التذييل الوسطى.

footer_left_content string

محتوى خانة التذييل اليسرى.

watermark_text string

نص العلامة المائية.

watermark_opacity integer

شفافية العلامة المائية (0–100).

margin_top_mm integer

الهامش العلوي بالمليمتر (0–40).

margin_right_mm integer

الهامش الأيمن بالمليمتر (0–40).

margin_bottom_mm integer

الهامش السفلي بالمليمتر (0–40).

margin_left_mm integer

الهامش الأيسر بالمليمتر (0–40).

signatures_enabled boolean

طباعة كتلة الاعتماد أسفل المستند.

signatures_columns integer

عدد أعمدة كتلة الاعتماد (1–4).

signatures_title string

عنوان كتلة الاعتماد.

signatures array

الموقّعون: title_ar (مطلوب)، title_en، name، show_line. مصفوفة فارغة تحذفهم كلّهم؛ غياب المفتاح يتركهم كما هم.

variables array

حقول القالب: key (مطلوب)، label_ar (مطلوب)، label_en، type (text|date|number|currency)، required، default_value. مفتاح يظلّل متغيّراً جاهزاً يُسقَط بصمت.