←همه اسناد
راهنمای Portal Studio

با خیال راحت بسازید.

یک مرجع عملی برای مدیران که تجربه مشتری و توسعه دهندگان را شکل می دهند، معماری واقعی استودیو را مستند می کند، مسیر آزاد را اداره می کند ، به مالکیت مرکزی ، هویت ، مهاجرت ها ، قراردادها و بازیابی قطعات کمک می کند.

پورتال سند v2مدیران + توسعه دهندهWorkflowبه روز رسانی 1 آگوست 2026
راهنمای مدیریت · معماری

می دانید که استودیو چه مالکیتی دارد

پورتال استودیو مالک پوسته مشتری است: صفحات، قرار دادن جزء، نشانه های برند، رفتار پاسخگو، ناوبری، ارائه هویت، سفر بلیط و انتشار.مرکز کمک دارای زبان، دسته ها، بخش ها و محتوای مقاله است. Studio مصرف می کند که محتوا از طریق یک پل محافظت شده؛ آن هرگز یک فروشگاه مقاله دوم ایجاد نمی کند.

کمک به مرکز + خدمات هویتآداپتورهای داده امنپیش نویس Portal Document v2یک کامپایلر و رندر کنندهپیش نمایش و منتشر شده Portal
یک قانون: پیش نمایش و صفحات عمومی از همان قرارداد سند / کپیلر استفاده می کنند، انتشارات هرگز به یک قالب غیر مرتبط تبدیل نمی شود.
نقشه ی Workspace
Live بومDesktop · مشتری
پورتال مشتریهمان سند ساختار یافته که در پیش نمایش و ارائه عمومی استفاده می شود
نقشه رابط: راه آهن شغلی، بوم زنده و بازرس انتخاب همان صفحه ثابت و گره را هدف قرار می دهند.
مدیر · Start

آمادگی کامل قبل از ساخت عمیق

  1. باز Open Portal Studio→شروع کار→Readiness.
  2. آدرس پورتال canonical را تأیید کنید و آن را در یک برگه جداگانه باز کنید.
  3. لوگو، آیکون مرورگر، نماد لمسی، تصویر اجتماعی و رنگ تم را تنظیم کنید.
  4. تأیید زبان های مرکز کمک؛ تغییر اقتدار زبان در مرکز کمک، نه استودیو.
  5. Configure Navigation و شرکت جهانی Footer
  6. یک سفر بلیط را انتخاب کنید و حداقل یک فرم درخواست را پیکربندی کنید.
  7. حداقل یک روش ثبت نام ایمن را فعال و کشف هویت بررسی کنید.
  8. کیفیت را اجرا کنید و دست های پیش نمایش امضا شده را ایجاد کنید.
  9. اولین انتشار کنترل شده را پس از هر آیتم مسدود کننده روشن کنید.

درصد آمادگی از داده های ذخیره شده ی workspace و حالت پیش نمایش محاسبه می شود.انتخاب یک مسیر آیتم به طور مستقیم به پنل خود.

مدیر · ساخت

ساخت صفحات و بخش های قابل استفاده

  1. باز Open ساخت → صفحات یک صفحه سیستم محافظت شده را انتخاب کنید یا یک صفحه سفارشی ایجاد کنید.
  2. مسیر، عنوان، حالت دسترسی و رفتار محلی را تنظیم کنید. مسیرهای سیستم محافظت شده نمی توانند حذف شوند.
  3. باز Open قطعاتفیلتر کردن توسط شغل یا بلوغ و قرار دادن یک جزء در یک اسلات سازگار.
  4. از بازرس برای محتوا، ظاهر، اتصال، دید و دسترسی استفاده کنید.
  5. از الگوهای قابل استفاده مجدد برای ساختارهای تکراری استفاده کنید؛ سازمان یا تفاوت های برند را در انواع مختلف نگه دارید.
  6. پس انداز پیش نویس و بارگیری ورزش، خالی، خطا، مهمان و امضا شده در حالت های پیش نمایش.
کتابخانه ی اجزایی · نقشه رابط کاربری Sanitized
جستجوی دانشمشتری امنشبکه های گروهیکمک به مرکزماده بدنترجمه DTOفرم Request form· نسخهجدول زمانی بلیطهشدار بتانمودار داده هابلوک های برنامه ریزی شده · انتشار
نقشه واسط: دسته، سازگاری و بلوغ قبل از قرار دادن اجزای برنامه ریزی شده برای انتشار قابل مشاهده هستند؛ اجزای بتا نیاز به درمان آزاد صریح دارند.
مدیر · برند و پاسخگو

سفر های واقعی را پیش بینی کنید، نه یک صفحه نمایش خوشحال

  1. پشتیبانی مهمان، بلیط امضا شده، مراقبت از صورتحساب، سازمان یا دست دادن دانش را انتخاب کنید.
  2. سوئیچ کردن به صورت، سازمان، نقش و کمک به زبان مرکزی.
  3. بررسی تلفن همراه، بزرگ موبایل، تبلت، لپ تاپ، دسکتاپ، گسترده و نقاط شکست فوق العاده.
  4. بررسی ارزش های ارثی، بیش از حد و تنظیم مجدد؛ اجتناب از تکرار بی نیاز
  5. صفحه کلید، RTL، کاهش احساسات، بارگیری، خالی، در دسترس نیست و اجازه ایالت ها.
  6. از آزمایشگاه تست برای دسترسی، محموله، مسیر، الزام آور و یافته های رندر کننده قبل از بررسی استفاده کنید.
یک بوم سبز تصمیم آزادی نیست، پیش از پرواز، بررسی وضعیت، قابلیت ها و شواهد انتشار تصمیم می گیرند که آیا پورتال ممکن است منتشر شود.
مدیر · تجربه

یک مرکز کمک سطح Zendesk بدون محتوای تکراری

  1. ایجاد دسته ها، بخش ها، مقالات، ترجمه ها، وابستگی ها و قالب ها در مرکز کمک.
  2. زبان های فعال در آنجا؛ زبان های محلی، جستجو، تغذیه،SEOو مقاله Chrome همان اقتدار را دنبال می کند.
  3. در استودیو، جستجوی دانش، شبکه های منبع / بخش، فیدها، انطباق موضوع، مقاله، جدول محتویات، بازخورد، مرتبط و قبلی / بعدی.
  4. Configure برجسته، محبوب و اخیر فید؛ استفاده از پیشنهادات متنی در جریان بلیط.
  5. پیش‌نمایش بدون نتیجه، مقالات طولانی، پیوست‌ها، بازخورد، مشاهده/اشتراک و تحویل بلیط.
  6. مسیر محلی تمیز، کانونical /hreflang، داده های ساختاری و بی اعتبار بودن پس از انتشار را بررسی کنید.
مرز: ویرایش محتوا و زبان های مشتری در مرکز کمک استفاده از پورتال Studio تنها به منظور ایجاد دانش کشف شده و نمایش داده می شود.
• مدیریت هویت و سازمان ها

برچسب ها: In Safe

  1. باز Open هویت و سازمان ها→هویت و حداقل یک راه را در مسیر خود فعال کنید.
  2. روش پیش فرض، سیاست ثبت نام، مدت زمان جلسه را انتخاب کنید SSO اجرای دامنه و رفتار کشف
  3. ارائه دهندگان را با زمینه های مسیریابی بصری اضافه کنید: نوع، دامنه ها، اولویت، ارائه، فعال و تایید وضعیت اسرار در زیر سیستم هویت باقی می مانند.
  4. برای SCIM, امکان تهیه ، کپی کردن نقطه پایانی دقیق فضای کار و چرخش توکن.فروش یک بار در IdP
  5. ادعاهای نقشه و عضویت سازمان، سپس ایجاد، به روز رسانی، عضویت گروه و غیرفعال کردن با یک مستاجر تست.
  6. مهمان پیش نمایش، مشتری، سازمان های نمایندگی شده و دولت ها را قبل از انتشار مسدود می کند.
هرگز یک کوکی را به استودیو ارسال نکنید. SCIM این یک کارمند بدون جلسه، کار فضایی است. API یک توکن را پس از قرار گرفتن در معرض تصادفی بچرخانید.
سفر های بلیط

تکمیل سفر پشتیبانی کامل

  1. فرم مستقیم، جادوگر، جستجو اول، هاب یا ورودی سرویس را انتخاب کنید.
  2. یک فرم درخواست نسخه شده با بخش ها و برچسب های فیلد قابل دسترس ایجاد کنید.
  3. ایجاد شرایط بصری، مسیریابی، SLA و مراحل تایید؛ پیشرفته JSON فقط برای تغییرات توسعه دهنده بررسی شده است.
  4. لیست شکل، جزئیات، موضوعات، زمان بندی، پیوست، تایید، SLA و سطوح پاسخ.
  5. بررسی مهمان، درخواست های امضا شده، دید سازمان، خرابی آپلود، اطلاع رسانی ایمیل و دانش را رد کنید.
  6. پس انداز یک پیش نویس؛ انتشار تنها بعد از آداپتور مسیر و اطلاع رسانی مسیر قبل از پرواز.
مدیر · بازبینی و انتشار

حرکت از طریق یک آزادی اداره شده

دانلود رایگان سریال نجاتدر بررسیتایید شدهبرنامه ریزی یا منتشر شدهمشاهده یا بازگشت
  1. پیاده سازی اعتبار و تست آزمایشگاه یافته های مسدود کننده را حل کنید؛ هشدارهای مجاز را با زمینه تایید کنید.
  2. یادداشت های انتشار و بررسی درخواست را اضافه کنید. Reviewers در مورد مسیر ثابت صفحه / آدرس سایت اظهار نظر می کنند.
  3. Approvers توزیع، پیش نمایش سفرها، تغییرات مجوز و شواهد را بررسی می کند.
  4. انتشار یا برنامه از طریق کارگر پس زمینه. ترک استودیو یک کار بادوام را لغو نمی کند.
  5. پیشرفت، سلامت و شناسه همبستگی را مشاهده کنید. توقف / فقط از کنترل های شغلی استفاده کنید.
  6. مسیر های بحرانی، هویت، بلیط ها و دانش را بررسی کنید. رول به یک آزادی پیش از تغییرناپذیر در صورت لزوم.
قابلیتهدف
نمایش / ویرایشبررسی یا تغییر پیش نویس بدون مجوز
دانلود بازی Approveبازخورد و تایید جداگانه از مجوز
برنامه / انتشار / Rollbackکنترل های مستقل تولید
هویت / SCIM مهاجرت / اجزای / تشخیصمحدود کردن عملیات تخصصی حساس
• مهاجرت و گسترش

مهاجرت با شواهد و یک راه بازگشت

  1. طرح ارائه دهنده را انتخاب کنید و یک دویدن خشک ایجاد کنید.
  2. تنظیمات کشف شده، ارزش های بی نظیر، شمارش محتوا و ثبت نام بصری.
  3. نقشه برداری های امن کامل و اجرای مجدد پراکندگی ساختاری
  4. برای یک پیش نویس، حساب های سازگار و پیش نمایش هر سفر محافظت شده استفاده کنید.
  5. پذیرش مجاز ثبت شده؛ هرگز انتشار فعلی منتشر شده در طول واردات را بیش از حد بازنویسی نکنید.
  6. از طریق حکومت و نگه داشتن گزارش مهاجرت، آزاد ID و رولبک نقطه با هم.
راهنمای توسعه دهنده · معماری

تمدید قراردادها، نه قالب ها

یک پسوند امن ثبت نام یک نوع عنصر پایدار و طرح، اعلام مجوز و نیازهای داده ها، ارائه از طریق کامپایلر کانونی، و لوازم تعیین کننده / آزمون. JavaScript در پورتال عمومی، یک مخزن مقاله دیگر ایجاد کنید یا دروازه آزاد را دور بزنید.

پورتال سند v2

صفحات حاوی گره های پایدار، اسلات ها، ویژگی ها، اتصالات، معافیت های پاسخگو، شرایط و دسترسی به متاداده هستند.

بایگانی برچسب ها

یک قرارداد، استودیو، کامپایلر، اسناد، مهاجرت و بررسی های بلوغ را تغذیه می کند.

بایگانی برچسب ها

گزینه Allowlisted, read-scoped DTOs جایگزین خودسرانه SQL یا فعالیت های پویا.

یک رندر کننده

Preview و عمومی خروجی جمع آوری، ایمن سازی، بودجه و حالت های زمان اجرا را به اشتراک می گذارند.

توسعه دهنده · قرارداد

تعریف یک بسته جزء

از یک نام پایین تر استفاده کنید ID و نسخه معنایی.هر دو نام املاک سازگاری را نشان می دهد زیرا بازرسی بسته و اعتبار امنیتی بررسی های مستقل انجام می دهند.

{
  "schema_version": 1,
  "id": "acme.support_health",
  "slug": "acme-support-health",
  "name": "Support health",
  "version": "1.0.0",
  "entry": "renderer.php",
  "renderer": "server",
  "server_renderer": "renderer.php",
  "public_renderer": "public.js",
  "schema": {
    "type": "object",
    "properties": {
      "heading": {"type": "string", "maxLength": 120},
      "showSla": {"type": "boolean", "default": true}
    },
    "additionalProperties": false
  },
  "permissions": ["tickets.read"],
  "data_scopes": ["tickets.mine"],
  "accessibility": {
    "landmark": "section",
    "nameFrom": "heading",
    "emptyState": true,
    "errorState": true
  },
  "performance": {"max_js_bytes": 12000, "max_css_bytes": 8000},
  "performance_budget": {"js": 12000, "css": 8000, "requests": 0}
}

شکل گره

{
  "id": "node-support-health",
  "type": "custom.acme_support_health",
  "props": {"heading": "Support health", "showSla": true},
  "bindings": {"requests": {"source": "tickets.mine", "limit": 5}},
  "responsive": {"mobile": {"padding": "16px"}, "desktop": {"padding": "24px"}},
  "conditions": [{"field": "identity.signed_in", "operator": "equals", "value": true}],
  "a11y": {"label": "Support health"}
}
  • شناسه ها در سراسر ویرایش و مهاجرت پایدار باقی می مانند.
  • خواص زمین های ناشناخته و ناامن را رد می کند HTML.
  • هر دیدگاه داده ای، بارگذاری، خالی، اجازه و خروجی مجدد را تعریف می کند.
  • اجزای کانتینری اسلات های خود را نام می برند؛ برگ ها نمی توانند کودکان دلخواه را بپذیرند.
  • مارک بلوغ صادقانه: بلوک های برنامه ریزی شده، هشدار بتا، GA نیاز به شواهد کامل دارد.
توسعه دهنده · منابع داده و الزام آور

استفاده از DTO های امن

  1. گزینه های موجود مانند شناسه ای را انتخاب کنید tickets.mine, knowledge.featured یا customer.profile.
  2. تنها فیلدهای اعلام شده توسط منابع DTO. ناشناخته با منابع ناشناخته شکست می خورند data_source.unknown.
  3. در این حالت، هیچ‌گاه هویت فضای کاری/کاربر را از یک دارایی غیرقابل اعتماد قبول نکنید.
  4. محدودیت های لیست برای مسدود شدن1–100 عادی کردن دزدی، ارزش های محلی و جستجو
  5. اگر یک منبع جدید اجتناب ناپذیر است، تعریف پایدار خود را اضافه کنید، نقشه برداری ایمن، مجوز ها، رفتار خالی و پیش نمایش با هم.
{
  "success": true,
  "source": "tickets.mine",
  "contract_version": 1,
  "items": [
    {"id": 42, "number": "REQ-42", "subject": "Example", "status": "open"}
  ]
}
منابع داده تنها خوانده می شوند. Mutations نیاز به یک اقدام خدمات مجوز صریح، اتصال فضای کاری، CSRF / جلسه یا اعتبار دهنده، IDempotency که در آن مورد نیاز و یک پاکت خطای تایپ شده است.
توسعه دهنده · امنیت

در داخل مرزهای اعتماد بمانید

مرزرفتار مورد نیاز
فضای کاریحل و فصل از میزبان / روتر قابل اعتماد، سپس هر خواندن و نوشتن قبل از اعدام را در بر می گیرد.
HTMLاستفاده از پورتال sanitizer / اجازه دهنده Parslist هرگز ویژگی های غیر قابل اعتماد را در بر نمی گیرد. URLs, CSS یا اسکریپت.
پیش‌نمایشنیاز به پنجره منبع همان ورودی، نسخه کانال امضا شده و بدون هیچ گونه پیام.
هویترازهای خارج از اسناد را نگه دارید. SCIM در این میان، به صورت مستمر و بی طرف و دارای فضای کاری می باشد.
بسته هارد مسیر های مطلق، لینک ها و فایل های ویژه، آرشیو های بیش از اندازه، بررسی / عدم تطابق و مجوزهای ناشناخته.
خطایبازگشت کد پایدار، پیام امن، تجدید نظر، اصلاح و شناسه همبستگی؛ ثبت استثناهای خصوصی در کنار سرور.
دانشاز طریق HelpCenterBridge. Never Author یا تکراری Help Center مقالات در یک پسوند بخوانید.
{
  "success": false,
  "error": {
    "code": "studio.permission_denied",
    "message": "You do not have permission to publish the Portal.",
    "retryable": false,
    "correlation_id": "ps_…",
    "meta": {"capability": "publish"}
  }
}
توسعه دهنده · بسته و مهاجرت

بررسی، نصب و ارتقاء اتمی

  1. Leave Put component.json در ریشه ی پستی و هر مسیر را به طور نسبی نگه دارید.
  2. ابتدا بررسی کنید: The installer caps بایگانی در 500 ورودی ها و 25 MB استخراج شده؛ اعتبار امنیتی محدودیت های مستقل را اضافه می کند.
  3. بررسی های مورد انتظار SHA-256 امضای بسته در فرآیند انتشار
  4. نصب به یک دایرکتوری نسخه شده هرگز یک نسخه نصب شده را در محل تغییر ندهید.
  5. ارائه مهاجرت اموال برای شکستن تغییرات طرح و حفظ زمینه های سازگاری ناشناخته.
  6. عنصر را در یک پیش نویس باز کنید، هر حالت / گزارش / شخصه را اجرا کنید و از طریق حکومت منتشر کنید.
  7. روبوتن (Roadback) عامل اصلی پیشین/ آزاد سازی تغییرناپذیر را فعال می کند؛ شواهد بازتولید آن را حفظ می کند.
توسعه دهنده · تست ها و آزادی

توسعه در همان هش انتشار

php tools/portal_studio_certify.php --source-only --json
php tools/test_portal_studio_contract.php
php tools/test_portal_one_renderer.php
php tools/test_portal_studio_engineer.php
php tools/test_portal_component_contracts.php
php tools/test_portal_one_renderer.php
php tools/test_portal_shell_contract.php
php tools/test_portal_knowledge_contract.php
node node_modules/@playwright/test/cli.js test tests/e2e/portal-studio-shell-visual-contract.spec.js tests/e2e/portal-custom-code-runtime.spec.js

دروازه های منبع لازم هستند، نه کافی پایگاه داده / مهاجرت، بصری واقعی، ارائه دهنده هویت، مجوز، دسترسی، عملکرد، صف / cron، ایمیل / پیوست، پشتیبان گیری / فروشگاه و شواهد استقرار به هش نسخه غیر قابل تغییر.

  • واحد: طرح، ایمن سازی، شکل DTO، شرایط، مهاجرت و شکست های نوع.
  • قرارداد: بارگذاری / خالی / موفقیت، بلوغ، اسلات ها، الزام و برابری یک نفره.
  • Browser: صفحه کلید، تمرکز، معنایی، RTL، زوم / جریان، کاهش حرکت و هر نقطه استراحت.
  • امنیت: کاوشگرهای متقابل فضایی، اقدامات ساختگی، حملات بسته، پیش نمایش و نشت مخفی.
  • عملیات: پیشرفت پایدار، ترک / بازگشت، توقف / استراحت / سر و صدا، ضربان قلب برنامه ریزی و رولبک.
مدیر + توسعه دهنده · Recovery

عیب یابی توسط State and Solidarity ID

دولت ایالتیچه کاری باید انجام دهید
مجوزدرخواست قابلیت نام گذاری UI Hidden راحتی است؛ backend همیشه آن را اجرا می کند.
اعتبارسنجیصفحه / سایت گزارش شده را باز کنید، آن را تصحیح کنید و سپس قبل از پرواز دوباره اجرا کنید.
تضادآخرین تجدید نظر، مقایسه تغییرات و دوباره به طور عمدی.هرگز بیش از حد فشار ندهید.
آفلاین / Retryableپیش نویس، اتصال را نگه دارید، از طریق عمل دوباره تلاش کنید و وضعیت شغلی پایدار را تأیید کنید.
دانلود زیرنویس فارسی فیلم In دسترسکپی کردن شناسه همبستگی و زمان بندی برای پشتیبانی.هرگز اسرار یا متن استثنا خصوصی را پنهان نکنید.
انتشار شکست خوردبررسی خروجی پیش پرواز / شغل، فقط مراحل دوباره امتحان کنید یا به آخرین آزادی سالم برگردید.
SCIM 401/403تایید نقطه پایانی / فضای کاری، توکن حامل، حالت و چرخش را فعال می کند؛ هرگز از کوکی جلسه مرورگر استفاده نکنید.
دانش است.بررسی محلی / عمومی در مرکز کمک، سپس تجزیه و تحلیل حافظه کش و مسیر تمیز محلی.

این راهنما آماده چاپ است.استفاده از Print→ذخیره سازیPDFبرای یک کپی آفلاین کنترل شده