לדעת מה סטודיו
פורטל סטודיו הבעלים של הקליפה הפונה ללקוח: דפים, מיקום רכיב, אסימוני מותג, התנהגות תגובתית, ניווט, רגל, מצגת זהות, מסעי כרטיסים והודעות.מרכז העזרה יש שפות, קטגוריות, קטעים ותוכן מאמר. Studio צורכת תוכן זה באמצעות גשר מוגן; הוא לעולם לא יוצר חנות מאמרים שנייה.
מוכנות מלאה לפני בניית
- פתוח פורטל Studio→התחל להתחיל→Readness.
- לאשר את כתובת פורטל הקנון ולפתוח אותו בכרטיסיה נפרדת.
- הגדר את הלוגו, סמל הדפדפן, סמל מגע, תדמית חברתית וצבע נושא.
- אישור שפות מרכז עזרה; שינוי סמכות שפה במרכז העזרה, לא סטודיו.
- ניווט קונדס ו- Global Enterprise Footer
- בחרו מסע כרטיסים והגדרתו לפחות טופס בקשה אחד.
- שמור לפחות אחד בטוח שיטת זיהוי זהה פעיל ולבחון.
- הפעל איכות והקמת לחיצת יד מקדימה חתומה.
- יצירת השחרור הראשון הנשלט לאחר כל פריט חסום ברור.
אחוז המוכנות מחושב מהנתונים של סביבת העבודה והמדינה המקדימה.בחירת נתיבי פריט ישירות לפאנל משלהן.
לבנות דפים וקטעים הניתנים לחזרה
- פתוח לבנות→דפים בחר דף מערכת מוגן או ליצור דף מותאם אישית.
- הגדר את המסלול, הכותרת, מצב הגישה והתנהגות מקומית.כבישים במערכת מוגנים לא ניתן למחוק.
- פתוח רכיביםמסנן על ידי עבודה או בגרות, ומניח מרכיב בחיק מתאים.
- השתמש במפקח לתוכן, מראה, מחייב, חשיפה ונגישות.
- השתמש בדפוסים הניתנים לחזרה למבנים חוזרים; לשמור על הבדלי הארגון או המותג בגרסאות.
- שמור את הטיוטה ואת טעינת התרגיל, ריק, שגיאה, אורח וחתומה במדינות בתצוגה מקדימה.
צפייה במסעות אמיתיים, לא מסך מאושר
- בחר תמיכה באורח, כרטיס חתום, טיפול חיוב, ארגון או ידע.
- Switch Personas, ארגון, תפקיד ושפת מרכז העזרה.
- Inspect Mobile, גדול נייד, Tablet, מחשב נייד, שולחן עבודה, נקודות רחבות ורחבות.
- בדוק את ערכי ה-Overridden and reset; להימנע משכפול חסר צורך.
- הפעל מקלדת, RTL, מופחתת-תזונה, טעינה, ריקה, לא זמינה ורשאות.
- השתמש במעבדת מבחן עבור נגישות, תשלום, מסלול, מחייב ותוצאות הגשה לפני בחינה.
פתח מרכז עזרה ברמת Zendesk ללא תוכן כפול
- יצירת קטגוריות, קטעים, מאמרים, תרגומים, קבצים מצורפים ותבניות ב מרכז עזרה.
- שפות זמינות שם; סלוגים מקומיים, חיפוש, להאכיל, SEO ומאמר chrome עוקבים אחר אותה סמכות.
- באולפן, מקום חיפוש ידע, קטגוריות / מקורות רשת, הזנות, נספח נושא, מאמר, שולחן של תוכן, משוב, הקשורים ורכיבים קודמים/באים.
- תצורה שהוצגה, הזנות פופולריות ואחרונה; השתמש בהצעות קונטקסטואליות בתזרימי הכרטיסים.
- Preview no-results, מאמרים ארוכים, החזקות, משוב, שעון / ספאם וכרטיס יד.
- בדוק מסלולים מקומיים נקיים, canonical /hreflang, נתונים מובנים ו invalidation לאחר פרסום.
המונחים: בבטחה
- פתוח זהות וארגונים→זהות שמור לפחות על אחד הנתיבים.
- בחר שיטת ברירת מחדל, מדיניות רישום, משך ישיבה SSO התנהגות של אכיפה וגילוי.
- הוסף ספקים עם שדות קידוד חזותי: סוג, תחומים, עדיפות, מצגת, מדינה מופעלת ואומתית סודות להישאר במערכת זהות.
- For SCIM, לאפשר מתן, העתק את נקודת הקצה של סביבת העבודה המדויקת ולסובב את הסימון.חנות את האסימון חד פעמי ב- IdP.
- תביעות מפה וחברות ארגוניות, לאחר מכן מבחן ליצור, לעדכן, חברות קבוצתיות ופעולות עם דייר מבחן.
- אורח, לקוח, ארגון מוקצה וההגבלות חסומות לפני פרסום.
עקבו אחרי AllMusic Journey
- בחר טופס ישיר, קוסם, חיפוש ראשון, מרכז או כניסה של שירות.
- צור טופס בקשה בשם, גרסה מעודכנת עם חלקים ותוויות שדה נגישות.
- בנה תנאים חזותיים, מחיקה, SLA ופעולות אישור; מתקדמים JSON הוא מיועד לשינויים במפתח בלבד.
- הגדרות רשימה, פרטים, נושאים, קו זמן, ציטוט, אישור, SLA ומשטחי תשובה. Name
- בדיקת אורח, בקשות חתום, חשיפה ארגונית, העלאה של כשל, הודעת דואר אלקטרוני והשתקפות ידע.
- שמור טיוטה; לפרסם רק לאחר המודול מתאם והודעת נתיב לעבור לפני הטיסה.
לעבור דרך שחרור נשלט
- הפעלת אימות ומעבדת Test. Fix לחסום את הממצאים; להכיר אזהרות מותרות עם ההקשר.
- הוסף הערות שחרור ובקשה סקירה. Reviewers להגיב על מסלולים יציבים דף / לאדה.
- אישורים בודקים את המסעות המקדימה, שינויים באישור וראיות.
- לוח זמנים או לוח הזמנים באמצעות עובד רקע.יציאה מסטודיו לא מבטלת עבודה יציבה.
- צפה בהתקדמות, בריאות וזיהוי קורלציה.עצור/retry רק משליטה בעבודה.
- בדוק מסלולים קריטיים, זהות, כרטיסים וידע.ר.רול חזרה להודעה קודמת בלתי-מוגדרת בעת הצורך.
| יכולת Capability | מטרה |
|---|---|
| תגית: Edit | הוראות או שינוי ללא רשות שחרור. |
| ביקורת / Aprov | משוב נפרד ואישור מסמכות. |
| תגית: Publish / Rollback | פיקוח על ייצור עצמאי |
| זהות / SCIM / Migrate / Components / Diagnostics | הגבלות פעילות מומחה רגישה |
למד עם ראיות והדרך חזרה
- בחר את מדפסת ה-Blueprint של הספק ויצור ריצה יבשה.
- עיין בהגדרות, ערכים לא ממופים, ספירות תוכן ולכידת parity חזותי.
- מיפוי בטוח לחלוטין ושיקום הקובע המובנה.
- החל טיוטה, ליישב ספירות ותצוגה מקדימה כל מסע מוגן.
- רישום קבלה מורשה; לעולם אל תכתבו את השחרור שפורסם לאחרונה במהלך היבוא.
- עבוד באמצעות ממשל ושמור את דוח ההגירה, לשחרר זהות ונקודת רולבק יחד.
חוזים מתקדמים, לא תבניות
הרחבה בטוחה רשומה עם סוג של מרכיב יציב וסכמה, מכריזה על זכויות וצרכים של נתונים, מציגה דרך הממיר הקנוני ומספקת התאמות/ בדיקות דטרמיניסטיות. אל תשאלו טבלאות שרירותיות, הזריקו את העורך JavaScript לתוך השער הציבורי, יצרו מאגר חדש למאמרים או עברו על שערי שחרור.
מסמך פורטל V2
דפים מכילים צמתים יציבים, חריצים, תכונות, מחייבות, חסרונות תגובתיים, תנאים ו metadata נגישות.
הרשמה
חוזה אחד מאכיל סטודיו, מדר, תיעוד, בדיקות הגירה וגרות.
מקור נתונים
מאפשר, קורא-רק, הרשאה-פיקד DTO להחליף שרירותי SQL או פעולות דינמיות.
אחד המונחים
תצוגה ופלט ציבורי חולקים אוסף, סניטוביזציה, תקציבים ומדינות במשרה מלאה.
Define a רכיב החבילה
השתמש בקובץ מזהה נמוך יותר וגרסה סמנטית.אספקת שמות נכסים תאימות המוצגים כי בדיקת חבילה ואימות אבטחה לבצע בדיקות עצמאיות.
{
"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 דורש ראיות מלאות.
שימוש ב- DTOS
- בחרו מזהה קיים כגון
tickets.mine,knowledge.featuredאוcustomer.profile. - רק שדות שהכריזו על ידי הגירסה שלו DTO.מקורות לא ידועים נכשלים עם מקורות בלתי ידועים
data_source.unknown. - לעבור את ההקשר פורטל מורשה כבר; לעולם אל תקבל זהות עבודה / לקוח מנכס לא מהימן.
- גבולות הרשימה מותקפים1–100.נרמל את הדמיון, המקומי וערכי החיפוש.
- אם מקור חדש הוא בלתי נמנע, להוסיף את ההגדרה היציבה שלו, מיפוי בטוח, הרשאות, התנהגות ריקה ותיקון תצוגה מקדימה יחד.
{
"success": true,
"source": "tickets.mine",
"contract_version": 1,
"items": [
{"id": 42, "number": "REQ-42", "subject": "Example", "status": "open"}
]
}
הישארו בתוך גבולות האמון
| ממזר | התנהגות נדרשת |
|---|---|
| סביבת עבודה | לפתור מהמארח / הדרכונים המוערכים, ולאחר מכן למקם כל קריאה וכתיבה לפני ביצוע. |
| HTML | Use the Portal sanitizer/parser allowlist. Never concatenate untrusted attributes, URLs, CSS or script. |
| ביקורת | נדרש חלון מקור זהה של אותו מקור, חתימה על גרסת ערוץ ו nonce. Ignore unsolicited הודעות. |
| זהות | שמור סודות מחוץ למסמכים. SCIM הוא דובר-אוהותי, ללא הישיבות ומרחב העבודה. |
| חבילות | מסלולים מתמשכים, נתיבים מוחלטים, קישורים / קבצים מיוחדים, ארכיוןים בגודל יתר, בדיקותum/signature לא מתאים ורשאות לא ידועות. |
| טעויות | החזרת קוד יציב, מסר בטוח, דחייה וזיהוי קורלציה; לפרט חריגים פרטיים בצד השרת. |
| ידע | קרא באמצעות HelpCenterBridge. Never Author או לשכפל מאמרים במרכז העזרה בהרחבה. |
{
"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"}
}
}
Inspect, להתקין ולשפר מבחינה אטומית
- לשים
component.jsonבשורש ZIP, לשמור על כל נתיב יחסי. - הפעל בדיקה ראשונה.The Installer caps Archives at 500 ערכים ו 25 MB מיצוי; אימות אבטחה מוסיף מגבלות עצמאיות.
- Verify the expected SHA-256 and package signature in the release process.
- התקן לבמאית גרסה מעודכנת. Never mutate an Install version in place.
- לספק הגירה רכוש על מנת לשבור שינויים סכימה ולשמור שדות תאימות לא ידועים.
- פתח את הרכיב בטיוטה, להפעיל כל תיקון מצב/ראייה/אישיות ופרסום באמצעות ממשל.
- רולבק מפעיל את שחרור הרכיב/ההביצועים הקודמים; לשמור על ראיות הכדאיות שלו.
להוכיח את הסיומת על אותו שחרור ישה
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
שערי המקור הם הכרחיים, לא מספיק.מסד נתונים / אינטגרציה, חזותי אמיתי-browser חזותית, זהות-פרוספקר, אישור-התמדה, נגישות, ביצועים, תור/cron, דואר / הקצאה, גיבוי / חזרה וראיות פריסה לאותה שחרור בלתי מודע נדרש ראיות כדי להיכשל את השחרור.
- יחידה: סכמה, סניטובה, צורת DTO, תנאים, הגירה וכישלונות מטיפוס.
- חוזים: טעינה / פחד / צואה, בגרות, חריצים, מחייבות ושוויון קטלני.
- דפדפן: מקלדת, מיקוד, סמנטיקה, RTL, Zoom /reflow, תנועה מופחתת וכל נקודת הפסקה.
- אבטחה: בדיקות חלל חוצה, פעולות מזויפות, התקפות חבילה, הצצה מקדימה ודליפה סודית.
- פעילות: התקדמות ממושכת, יציאה / חזרה, עצירה / ריצה / מנוחה, פעימות לב לוח הזמנים וגלגל בחזרה.
פתרון בעיות על ידי המדינה ו- התכתבות מזהה
| מדינת המדינה | מה לעשות |
|---|---|
| רשות | בקש את היכולת המוסתרת UI הוא נוחות; ה backend תמיד לאכוף אותו. |
| אימות | פתח את הדף / Nde/field, לתקן אותו, ולאחר מכן ליזום מחדש את הטיסה. |
| סכסוך | לנסח מחדש את התיקון האחרון, להשוות שינויים ובאופן מכוון.לעולם אל תאלץ לרסן את הטקס. |
| המונחים: retryable | שמור על הטיוטה, לשחזר קישוריות, לעבור את הפעולה ולוודא מצב עבודה עמיד. |
| שומן / לא זמין | העתק את מזהה התואם ואת הזמן דגימת התמיכה.לעולם אל תדביק סודות או טקסט יוצא דופן פרטי. |
| פובליש נכשל | תפוקה טרום טיסה / עבודה, retry רק שלבים הניתנים לחזרה, או לחזור לשחרור בריא האחרון. |
| SCIM 401/403 | קצה/מרחב עבודה, טוקן דובים, מצב וסיבוב; לעולם אל תשתמש בקובץ cookie של ישיבת דפדפן. |
| ידע הוא stale | בדוק את מקומי / פרסום במרכז העזרה, ולאחר מכן לבדוק אי-הסתערות מטמון ואת המסלול המקומי הנקי. |
מדריך זה הוא Print-ready. Use Print→לחסוךPDFעבור עותק לא מקוון מבוקר