Kujua nini studio ni
Portal Studio inamiliki shell ya wateja: kurasa, uwekaji wa sehemu, ishara za bidhaa, tabia ya msikivu, urambazaji, footer, uwasilishaji wa utambulisho, safari za tiketi na releases. Kituo cha Msaada kinamiliki lugha, makundi, sehemu na maudhui ya makala. studio hutumia yaliyomo kupitia daraja lililolindwa; kamwe haiunda duka la pili la makala.
Ukamilifu kabla ya kujenga
- Kufungua Tovuti ya Studio→Mwanzo wa kuanza→Kusoma kwa.
- Thibitisha anwani ya Portal ya Canton na uifungue kwenye tab tofauti.
- Weka alama, icon ya kivinjari, kugusa icon, picha ya kijamii na rangi ya mandhari.
- Thibitisha lugha za Kituo cha Msaada; Badilisha mamlaka ya lugha katika Kituo cha Usaidizi, sio Studio.
- Kulinganisha urambazaji na footer ya biashara ya kimataifa.
- Chagua safari ya tiketi na usanidi angalau fomu moja ya maombi.
- Weka angalau njia moja salama ya kuingia na kuchunguza ugunduzi wa utambulisho.
- Kukimbia ubora na kuanzisha saini preview handshake.
- Unda toleo la kwanza linalosimamiwa baada ya kila kitu cha kuzuia ni wazi.
Asilimia ya utayarishaji imehesabiwa kutoka data ya kazi iliyohifadhiwa na hali ya hakikisho. Kuchagua njia za bidhaa moja kwa moja kwenye jopo lake la kumiliki.
Kujenga kurasa na sehemu za reusable
- Kufungua Kujenga kujenga→Ukurasa wa Chagua ukurasa wa mfumo uliohifadhiwa au uunda ukurasa wa desturi.
- Weka njia, kichwa, hali ya upatikanaji na tabia za ndani. Njia za mfumo wa ulinzi haziwezi kufutwa.
- Kufungua Vipengele vya Element, filter kwa kazi au ukomavu, na kuweka sehemu katika yanayopangwa sambamba.
- Tumia mkaguzi wa maudhui, kuonekana, kumfunga, kujulikana na upatikanaji.
- Tumia mifumo inayoweza kurejeshwa kwa miundo ya mara kwa mara; kuweka shirika au tofauti za chapa katika anuwai.
- Hifadhi rasimu na zoezi upakiaji, tupu, makosa, mgeni na saini katika preview.
Kusubiri safari halisi, si moja ya furaha screen
- Chagua msaada wa wageni, tiketi iliyosainiwa, huduma ya bili, shirika au ujuzi.
- Badilisha mtu, shirika, jukumu na lugha ya Kituo cha Msaada.
- Simu ya siri, simu kubwa, kibao, laptop, desktop, vituo vya mapumziko pana na ultrawide.
- Angalia urithi, overridden na maadili ya upya; epuka uharibifu wa breakpoint usiohitajika.
- Tumia keyboard, RTL, kupungua kwa hisia, upakiaji, tupu, zisizopatikana na ruhusa.
- Tumia Lab ya mtihani kwa upatikanaji, malipo, njia, matokeo ya kisheria na ya muuzaji kabla ya ukaguzi.
Tumia Kituo cha Msaada wa Zendesk bila maudhui ya duplicate
- Kujenga makundi, sehemu, makala, tafsiri, vifungo na templates katika Kituo cha Msaada.
- Kuwezesha lugha huko; slugs za mitaa, utafutaji, feeds, SEO na makala chrome kufuata mamlaka sawa.
- Katika Studio, tafuta maarifa ya mahali, gridi za jamii / rasilimali, feeds, mkusanyiko wa mada, makala, meza ya yaliyomo, maoni, vipengele vinavyohusiana na uliopita / usio.
- Picha featured, maarufu na feeds hivi karibuni; kutumia mapendekezo contextual katika mtiririko wa tiketi.
- Preview hakuna matokeo, makala ndefu, vifungo, maoni, watch / usajili na tiketi ya handoff.
- Kuthibitisha njia safi za mitaa, canonical / hreflang, data ya muundo na kufuta cache baada ya kuchapishwa.
Kuweka alama katika usalama
- Kufungua Utambulisho na Mashirika→Utambulisho wa utambulisho Weka angalau moja ya njia zilizoelezwa hapo juu.
- Chagua njia ya default, sera ya usajili, muda wa kikao, SSO-domain utekelezaji na tabia ya ugunduzi.
- Ongeza watoa huduma na maeneo ya uendeshaji wa kuona: aina, vikoa, kipaumbele, uwasilishaji, kuwezeshwa na kuthibitishwa. siri hukaa katika mfumo wa utambulisho.
- Kwa SCIM, kuwezesha utoaji, nakala ya mwisho halisi wa nafasi ya kazi na kuzunguka ishara. Hifadhi ishara ya wakati mmoja katika IdP.
- Map madai na uanachama wa shirika, kisha mtihani kujenga, update, kundi wanachama na deactivation na tenant mtihani.
- Mgeni wa Preview, mteja, shirika lililotumwa na kuzuia majimbo kabla ya kuchapishwa.
Kukamilisha safari ya msaada
- Chagua fomu ya moja kwa moja, mchawi, utafutaji wa kwanza, kitovu au kuingia kwenye huduma-desk.
- Unda fomu ya ombi la jina na sehemu na maandiko ya shamba kupatikana.
- Kujenga hali ya kuona, routing, SLA na hatua za idhini; juu JSON ni kwa mabadiliko ya msanidi programu yaliyopitiwa tu.
- Orodha ya takwimu, maelezo, thread, ratiba, attachment, kibali, SLA na majibu nyuso.
- Uchunguzi wa mgeni wa mtihani, maombi ya saini, kuonekana kwa shirika, kushindwa kupakia, taarifa ya barua pepe na ufahamu.
- Hifadhi rasimu; kuchapisha tu baada ya adapta ya njia na taarifa ya njia kabla ya kupitisha.
Kujiondoa kwa njia ya uchaguzi
- Tumia uthibitisho na Lab ya Mtihani. kurekebisha matokeo ya kuzuia; kukubali maonyo yaliyoruhusiwa kwa muktadha.
- Ongeza maelezo ya kutolewa na uombe ukaguzi. Wahakiki wana maoni juu ya ukurasa thabiti / njia za kuzuia.
- Waidhinishaji hukagua safari za usambazaji, safari za hakikisho, mabadiliko ya ruhusa na ushahidi.
- Kuchapisha au ratiba kupitia mfanyakazi wa nyuma. Kuacha Studio haifuta kazi ya kudumu.
- Angalia maendeleo, afya na uwiano ID. Kuacha / kurejesha tu kutoka udhibiti wa kazi.
- Kuthibitisha njia muhimu, utambulisho, tiketi na maarifa. Roll nyuma kwa kutolewa kabla ya kutofautiana wakati inahitajika.
| Uwezo wa uwezo | Malengo ya malengo |
|---|---|
| Maoni / Edit | Kusubiri au kubadilisha rasimu bila mamlaka ya kutolewa. |
| Maoni / Kukubaliana | Kutenganisha maoni na idhini kutoka kwa uandishi. |
| Tarehe ya kuchapisha / Rollback | udhibiti wa uzalishaji huru. |
| Utambulisho / SCIM Uhamiaji / Components / Diagnostics | Kurejesha shughuli za kitaalamu. |
Kurejea kwa ushahidi na njia ya kurudi
- Chagua mpango wa mtoa huduma na uunda kukimbia kavu.
- Mapitio ya mipangilio iliyogunduliwa, maadili yasiyo na maana, hesabu za maudhui na kukamata usawa wa kuona.
- Kamili ramani salama na rerun usambazaji muundo.
- Tumia rasimu, kupatanisha hesabu na preview kila safari iliyohifadhiwa.
- Rekodi kukubalika mamlaka; kamwe overwrite ya sasa kuchapishwa kutolewa wakati wa kuagiza.
- Kuchapisha kupitia utawala na kuweka ripoti ya uhamiaji, kutoa ID na rollback hatua pamoja.
Kupanua mikataba, sio templates
Ugani salama unasajili aina ya sehemu imara na schema, inasema ruhusa na mahitaji ya data, hutoa kupitia mkusanyiko wa maandishi, na hutoa vifaa vya kuamua / majaribio. Usiulize meza za kiholela, mhariri wa sindano JavaScript ndani ya bandari ya umma, kuunda nakala nyingine ya kumbukumbu, au kupitisha lango la kutolewa.
Tovuti ya V2
Kurasa zina nodes imara, mipaka, mali, vifungo, overrides msikivu, hali na metadata upatikanaji.
Msajili wa
Mkataba mmoja feeds Studio, mkusanyiko, nyaraka, uhamiaji na ukaguzi wa ukomavu.
Taarifa ya Usajili wa Data
Kuruhusiwa, kusoma tu, ruhusa-scoped DTOs kuchukua nafasi ya kiholela SQL au vitendo vya nguvu.
Mmoja wa wafanyakazi
Preview na umma pato ukusanyaji, sanitization, bajeti na majimbo runtime.
Kufafanua sehemu ya mfuko
Tumia kitambulisho cha chini cha majina na toleo la semantic. Kutoa majina yote ya mali ya utangamano iliyoonyeshwa kwa sababu ukaguzi wa mfuko na uthibitisho wa usalama hufanya hundi za kujitegemea.
{
"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}
}
Aina ya Node
{
"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"}
}
- IDs bado imara katika hariri na uhamiaji.
- Wananchi wakataa maeneo yasiyotangazwa na yasiyo salama HTML.
- Kila mtazamo wa data-kufunga hufafanua upakiaji, tupu, ruhusa na pato la kurudia-error.
- Vipengele vya chombo vinataja mipaka yao; majani hayawezi kukubali watoto wa kiholela.
- Mark ukomavu kwa uaminifu: vitalu iliyopangwa, beta anaonya, GA inahitaji ushahidi kamili.
Tumia salama ya DTOs
- Chagua ID ya sasa kama vile
tickets.mine,knowledge.featuredaucustomer.profile. - Kufungia mashamba tu alitangaza kwa toleo lake DTO. vyanzo Unknown kushindwa na
data_source.unknown. - Tumia muktadha wa Portal ulioidhinishwa tayari; usikubali utambulisho wa workspace / mteja kutoka kwa mali isiyoaminika.
- Mipaka ya akaunti imeambatanishwa kwa1–100.Kuanzisha pagination, locale na thamani ya utafutaji.
- Ikiwa chanzo kipya hakikubaliki, ongeza ufafanuzi wake thabiti, ramani salama, ruhusa, tabia tupu na kurekebisha hakikisho pamoja.
{
"success": true,
"source": "tickets.mine",
"contract_version": 1,
"items": [
{"id": 42, "number": "REQ-42", "subject": "Example", "status": "open"}
]
}
Kukaa ndani ya mipaka ya uaminifu
| Bounda ya | Tabia zinazohitajika |
|---|---|
| Nafasi ya Kazi | Kutatua kutoka kwa mwenyeji anayeaminika / njia / uchunguzi, kisha ufikie kila kusoma na kuandika kabla ya utekelezaji. |
| HTML | Tumia kitakasaji cha Portal / msimamizi wa ruhusu.Usi kamwe usitie sifa zisizoaminika, URLs, CSS au kwa maandishi. |
| Tazama | Unahitaji dirisha la chanzo cha asili sawa, toleo la kituo kilichosainiwa na nonce. epuka ujumbe usioombwa. |
| Utambulisho wa utambulisho | Weka siri nje ya nyaraka. SCIM ni mchuuzi, asiye na kikao na nafasi ya kazi. |
| Packages ya | Kukataa traversal, njia kamili, viungo / faili maalum, kumbukumbu za ukubwa, checksum / ishara mismatch na ruhusa isiyojulikana. |
| Makosa ya | Kurudi msimbo thabiti, ujumbe salama, retryability, remediation na uwiano ID; logi isipokuwa ya seva binafsi upande. |
| Maarifa ya ujuzi | Soma kupitia HelpCenterBridge. Usiwahi kuandika au nakala za Kituo cha Msaada wa duplicate katika ugani. |
{
"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"}
}
}
Kutarajia, kufunga na kuboresha atomi
- Put ya
component.jsonkatika ngazi ya juu na kuhakikisha kila kitu kinakwenda sawa. - Kukagua kwanza, safisha nyaraka za ufungaji katika 500 Kuingia na kuingia 25 MB Kuondolewa; uthibitisho wa usalama huongeza mipaka ya kujitegemea.
- Angalia SHA-256 na saini ya mfuko katika mchakato wa kutolewa.
- Weka kwenye saraka iliyosasishwa. Usibadilisha toleo lililosanikishwa mahali.
- Kutoa uhamiaji wa mali kwa ajili ya kuvunja mabadiliko ya schema na kuhifadhi maeneo yasiyojulikana utangamano.
- Fungua sehemu katika rasimu, endesha kila hali / maoni / mtu na kuchapisha kupitia utawala.
- Rollback inaamsha kutolewa kwa sehemu isiyobadilika / hati; kuhifadhi ushahidi wake wa kurudia.
Kuthibitisha upanuzi juu ya kutolewa kwa Hash
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
Milango ya chanzo ni muhimu, haitoshi. Weka database / uhamiaji, databana halisi-browser Visual, mtoa utambulisho, upatikanaji, utendaji, foleni / mwamba, barua / usajili, Backup / restore na kupelekwa ushahidi kwa moja isiyobadilika kutolewa hash. Ushahidi unaohitajika lazima kushindwa kutolewa.
- Unit: schema, sanitization, sura ya DTO, hali, uhamiaji na kushindwa kwa aina.
- Mkataba: upakiaji / uchafu / ugaidi / mafanikio, ukomavu, mipaka, kumfunga na usawa wa moja.
- Kivinjari: keyboard, lengo, semantics, RTL, zoom / reflow, kupungua mwendo na kila breakpoint.
- Usalama: uchunguzi wa nafasi ya msalaba, vitendo vilivyobuniwa, mashambulizi ya mfuko, ufuatiliaji na uvujaji wa siri.
- Maandalizi: maendeleo ya kudumu, kuondoka / kurudi, kusimamisha / jaribio tena / kuendelea, scheduler moyo na rollback.
Matatizo ya Nchi na ID ya uwiano
| Hali | Nini cha kufanya |
|---|---|
| Ruhusa ya | Kuomba uwezo jina. UI siri ni urahisi; backend daima kutekeleza yake. |
| Uhalali wa | Fungua ukurasa ulioripotiwa / node / uwanja, uirekebishe, kisha ufanyie upya. |
| Mgogoro wa migogoro | Reload marekebisho ya hivi karibuni, kulinganisha mabadiliko na reapply kwa makusudi. kamwe nguvu overwrite. |
| Kuondolewa / retryable | Weka rasimu, kurejesha kuunganishwa, jaribu kupitia hatua na kuthibitisha hali ya kazi ya kudumu. |
| Uunganisho / usiowezekana | Nakala ya kitambulisho uwiano na timestamp kwa msaada. Kamwe kuweka siri au maandishi binafsi ubaguzi. |
| Mwandishi wa kushindwa | Kutarajia kabla ya kuanza / kazi, retry tu hatua za kurejesha, au kurudi kwenye kutolewa kwa mwisho wenye afya. |
| SCIM 401/403 | Thibitisha mwisho / nafasi ya kazi, ishara ya kubeba, kuwezesha hali na mzunguko; kamwe kutumia kidakuzi cha kikao cha kivinjari. |
| Maarifa ni ya kutosha | Thibitisha locale / uchapishaji katika Kituo cha Msaada, kisha kukagua ufuta wa cache na njia safi ya ndani. |
Mwongozo huu ni tayari kuchapishwa. Tumia Print → Save as PDF kwa nakala ya nje ya mtandao iliyodhibitiwa.