←Nyaraka zote
Mwongozo wa Mafunzo ya Portal

Kuchapisha kwa ujasiri.

Moja ya kumbukumbu ya vitendo kwa watendaji ambao huunda uzoefu wa wateja na watengenezaji ambao wanapanua. Inaandika usanifu halisi wa Studio, njia ya kutolewa, umiliki wa Kituo cha Msaada, utambulisho, uhamiaji, mikataba ya sehemu na kupona.

Tovuti ya V2Mtumiaji wa Developer +Biashara ya Kuzalisha KaziImesasishwa updated 1 Agosti ya Agosti 2026
Mwongozo wa Usimamizi · Usanifu

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.

Kituo cha Msaada + Tiketi ya UsajiliData salama ya adaptaFomu ya maombi ya V2Mmoja wa wauzaji na muuzajiPreview na Kuchapishwa Portal
Kanuni ya 1: preview na kurasa za umma kutumia hati hiyo / mkataba wa kampuni. Publication kamwe switches kwa template lisilohusiana.
Portal Studio · Ramani ya Kazi
Maisha ya rafuDesktop · Wateja
Portal ya WatejaHati hiyo ya muundo inayotumiwa katika preview na utoaji wa umma
Ramani ya interface: reli ya kazi, turubai za kuishi na mkaguzi hulenga ukurasa huo thabiti na uteuzi wa node.
· Mwanzo wa

Ukamilifu kabla ya kujenga

  1. Kufungua Tovuti ya Studio→Mwanzo wa kuanza→Kusoma kwa.
  2. Thibitisha anwani ya Portal ya Canton na uifungue kwenye tab tofauti.
  3. Weka alama, icon ya kivinjari, kugusa icon, picha ya kijamii na rangi ya mandhari.
  4. Thibitisha lugha za Kituo cha Msaada; Badilisha mamlaka ya lugha katika Kituo cha Usaidizi, sio Studio.
  5. Kulinganisha urambazaji na footer ya biashara ya kimataifa.
  6. Chagua safari ya tiketi na usanidi angalau fomu moja ya maombi.
  7. Weka angalau njia moja salama ya kuingia na kuchunguza ugunduzi wa utambulisho.
  8. Kukimbia ubora na kuanzisha saini preview handshake.
  9. 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.

· Kuundwa kwa

Kujenga kurasa na sehemu za reusable

  1. Kufungua Kujenga kujenga→Ukurasa wa Chagua ukurasa wa mfumo uliohifadhiwa au uunda ukurasa wa desturi.
  2. Weka njia, kichwa, hali ya upatikanaji na tabia za ndani. Njia za mfumo wa ulinzi haziwezi kufutwa.
  3. Kufungua Vipengele vya Element, filter kwa kazi au ukomavu, na kuweka sehemu katika yanayopangwa sambamba.
  4. Tumia mkaguzi wa maudhui, kuonekana, kumfunga, kujulikana na upatikanaji.
  5. Tumia mifumo inayoweza kurejeshwa kwa miundo ya mara kwa mara; kuweka shirika au tofauti za chapa katika anuwai.
  6. Hifadhi rasimu na zoezi upakiaji, tupu, makosa, mgeni na saini katika preview.
Ramani ya interface ya Sanitized
Kutafuta maarifa• Kuwa salama kwa watejaJamii ya RedKituo cha MsaadaMakala ya mwili· Kutafsiriwa kwa lugha ya KiswahiliFomu ya maombi· Kuchapishwatiketi ya wakatiBeta · Tahadhari yaData ya TakwimuKuchapishwa · Blocks kuchapisha
Ramani ya Interface: jamii, utangamano na ukomavu huonekana kabla ya uwekaji. Vipengele vilivyopangwa kuzuia uchapishaji; vipengele vya beta vinahitaji matibabu ya kutolewa wazi.
Usimamizi wa Brand na Usikivu

Kusubiri safari halisi, si moja ya furaha screen

  1. Chagua msaada wa wageni, tiketi iliyosainiwa, huduma ya bili, shirika au ujuzi.
  2. Badilisha mtu, shirika, jukumu na lugha ya Kituo cha Msaada.
  3. Simu ya siri, simu kubwa, kibao, laptop, desktop, vituo vya mapumziko pana na ultrawide.
  4. Angalia urithi, overridden na maadili ya upya; epuka uharibifu wa breakpoint usiohitajika.
  5. Tumia keyboard, RTL, kupungua kwa hisia, upakiaji, tupu, zisizopatikana na ruhusa.
  6. Tumia Lab ya mtihani kwa upatikanaji, malipo, njia, matokeo ya kisheria na ya muuzaji kabla ya ukaguzi.
kijani kanvas si uamuzi wa kutolewa. Kutawala preflight, tathmini ya hali, uwezo na ushahidi wa kutoa kuamua kama Portal inaweza kuchapisha.
· Uzoefu wa

Tumia Kituo cha Msaada wa Zendesk bila maudhui ya duplicate

  1. Kujenga makundi, sehemu, makala, tafsiri, vifungo na templates katika Kituo cha Msaada.
  2. Kuwezesha lugha huko; slugs za mitaa, utafutaji, feeds, SEO na makala chrome kufuata mamlaka sawa.
  3. Katika Studio, tafuta maarifa ya mahali, gridi za jamii / rasilimali, feeds, mkusanyiko wa mada, makala, meza ya yaliyomo, maoni, vipengele vinavyohusiana na uliopita / usio.
  4. Picha featured, maarufu na feeds hivi karibuni; kutumia mapendekezo contextual katika mtiririko wa tiketi.
  5. Preview hakuna matokeo, makala ndefu, vifungo, maoni, watch / usajili na tiketi ya handoff.
  6. Kuthibitisha njia safi za mitaa, canonical / hreflang, data ya muundo na kufuta cache baada ya kuchapishwa.
Mamlaka ya mipaka: Tumia Portal Studio ili kuandika jinsi maarifa yanavyopatikana na kuonyeshwa.
Msimamizi · Utambulisho na Mashirika

Kuweka alama katika usalama

  1. Kufungua Utambulisho na Mashirika→Utambulisho wa utambulisho Weka angalau moja ya njia zilizoelezwa hapo juu.
  2. Chagua njia ya default, sera ya usajili, muda wa kikao, SSO-domain utekelezaji na tabia ya ugunduzi.
  3. Ongeza watoa huduma na maeneo ya uendeshaji wa kuona: aina, vikoa, kipaumbele, uwasilishaji, kuwezeshwa na kuthibitishwa. siri hukaa katika mfumo wa utambulisho.
  4. Kwa SCIM, kuwezesha utoaji, nakala ya mwisho halisi wa nafasi ya kazi na kuzunguka ishara. Hifadhi ishara ya wakati mmoja katika IdP.
  5. Map madai na uanachama wa shirika, kisha mtihani kujenga, update, kundi wanachama na deactivation na tenant mtihani.
  6. Mgeni wa Preview, mteja, shirika lililotumwa na kuzuia majimbo kabla ya kuchapishwa.
Kamwe kutuma cookies kwa ajili ya kujifunza SCIM- Ni mchezaji asiye na kazi, mwenye nafasi ya kazi API· Kuweka alama baada ya kutokea kwa ajali.
Usafiri wa tiketi

Kukamilisha safari ya msaada

  1. Chagua fomu ya moja kwa moja, mchawi, utafutaji wa kwanza, kitovu au kuingia kwenye huduma-desk.
  2. Unda fomu ya ombi la jina na sehemu na maandiko ya shamba kupatikana.
  3. Kujenga hali ya kuona, routing, SLA na hatua za idhini; juu JSON ni kwa mabadiliko ya msanidi programu yaliyopitiwa tu.
  4. Orodha ya takwimu, maelezo, thread, ratiba, attachment, kibali, SLA na majibu nyuso.
  5. Uchunguzi wa mgeni wa mtihani, maombi ya saini, kuonekana kwa shirika, kushindwa kupakia, taarifa ya barua pepe na ufahamu.
  6. Hifadhi rasimu; kuchapisha tu baada ya adapta ya njia na taarifa ya njia kabla ya kupitisha.
· Kukagua na kutoa

Kujiondoa kwa njia ya uchaguzi

Mradi wa KuokolewaKatika ukaguziImeidhinishwaImeandaliwa au kuchapishwaKuondolewa au kuondolewa nyuma
  1. Tumia uthibitisho na Lab ya Mtihani. kurekebisha matokeo ya kuzuia; kukubali maonyo yaliyoruhusiwa kwa muktadha.
  2. Ongeza maelezo ya kutolewa na uombe ukaguzi. Wahakiki wana maoni juu ya ukurasa thabiti / njia za kuzuia.
  3. Waidhinishaji hukagua safari za usambazaji, safari za hakikisho, mabadiliko ya ruhusa na ushahidi.
  4. Kuchapisha au ratiba kupitia mfanyakazi wa nyuma. Kuacha Studio haifuta kazi ya kudumu.
  5. Angalia maendeleo, afya na uwiano ID. Kuacha / kurejesha tu kutoka udhibiti wa kazi.
  6. Kuthibitisha njia muhimu, utambulisho, tiketi na maarifa. Roll nyuma kwa kutolewa kabla ya kutofautiana wakati inahitajika.
Uwezo wa uwezoMalengo ya malengo
Maoni / EditKusubiri au kubadilisha rasimu bila mamlaka ya kutolewa.
Maoni / KukubalianaKutenganisha maoni na idhini kutoka kwa uandishi.
Tarehe ya kuchapisha / Rollbackudhibiti wa uzalishaji huru.
Utambulisho / SCIM Uhamiaji / Components / DiagnosticsKurejesha shughuli za kitaalamu.
· Kuhama na kuhamia

Kurejea kwa ushahidi na njia ya kurudi

  1. Chagua mpango wa mtoa huduma na uunda kukimbia kavu.
  2. Mapitio ya mipangilio iliyogunduliwa, maadili yasiyo na maana, hesabu za maudhui na kukamata usawa wa kuona.
  3. Kamili ramani salama na rerun usambazaji muundo.
  4. Tumia rasimu, kupatanisha hesabu na preview kila safari iliyohifadhiwa.
  5. Rekodi kukubalika mamlaka; kamwe overwrite ya sasa kuchapishwa kutolewa wakati wa kuagiza.
  6. Kuchapisha kupitia utawala na kuweka ripoti ya uhamiaji, kutoa ID na rollback hatua pamoja.
Mwongozo wa Kuendeleza Developer · Architecture

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.

· Mkataba wa makubaliano

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.
Developer · Vyanzo vya data na kumfunga

Tumia salama ya DTOs

  1. Chagua ID ya sasa kama vile tickets.mine, knowledge.featured au customer.profile.
  2. Kufungia mashamba tu alitangaza kwa toleo lake DTO. vyanzo Unknown kushindwa na data_source.unknown.
  3. Tumia muktadha wa Portal ulioidhinishwa tayari; usikubali utambulisho wa workspace / mteja kutoka kwa mali isiyoaminika.
  4. Mipaka ya akaunti imeambatanishwa kwa1–100.Kuanzisha pagination, locale na thamani ya utafutaji.
  5. 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"}
  ]
}
Vyanzo vya data vinasomwa tu. Matukio yanahitaji hatua ya huduma iliyoidhinishwa wazi, kumfunga kwa nafasi ya kazi, CSRF / uchunguzi au uthibitisho wa kubeba, idempotency ambapo inahitajika na bahasha ya kosa la aina.
Developer · Usalama wa

Kukaa ndani ya mipaka ya uaminifu

Bounda yaTabia zinazohitajika
Nafasi ya KaziKutatua kutoka kwa mwenyeji anayeaminika / njia / uchunguzi, kisha ufikie kila kusoma na kuandika kabla ya utekelezaji.
HTMLTumia kitakasaji cha Portal / msimamizi wa ruhusu.Usi kamwe usitie sifa zisizoaminika, URLs, CSS au kwa maandishi.
TazamaUnahitaji dirisha la chanzo cha asili sawa, toleo la kituo kilichosainiwa na nonce. epuka ujumbe usioombwa.
Utambulisho wa utambulishoWeka siri nje ya nyaraka. SCIM ni mchuuzi, asiye na kikao na nafasi ya kazi.
Packages yaKukataa traversal, njia kamili, viungo / faili maalum, kumbukumbu za ukubwa, checksum / ishara mismatch na ruhusa isiyojulikana.
Makosa yaKurudi msimbo thabiti, ujumbe salama, retryability, remediation na uwiano ID; logi isipokuwa ya seva binafsi upande.
Maarifa ya ujuziSoma 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"}
  }
}
Programu ya · Package na Uhamiaji

Kutarajia, kufunga na kuboresha atomi

  1. Put ya component.json katika ngazi ya juu na kuhakikisha kila kitu kinakwenda sawa.
  2. Kukagua kwanza, safisha nyaraka za ufungaji katika 500 Kuingia na kuingia 25 MB Kuondolewa; uthibitisho wa usalama huongeza mipaka ya kujitegemea.
  3. Angalia SHA-256 na saini ya mfuko katika mchakato wa kutolewa.
  4. Weka kwenye saraka iliyosasishwa. Usibadilisha toleo lililosanikishwa mahali.
  5. Kutoa uhamiaji wa mali kwa ajili ya kuvunja mabadiliko ya schema na kuhifadhi maeneo yasiyojulikana utangamano.
  6. Fungua sehemu katika rasimu, endesha kila hali / maoni / mtu na kuchapisha kupitia utawala.
  7. Rollback inaamsha kutolewa kwa sehemu isiyobadilika / hati; kuhifadhi ushahidi wake wa kurudia.
· Uchunguzi na Kuachiliwa

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.
Developer · Kufufua

Matatizo ya Nchi na ID ya uwiano

HaliNini cha kufanya
Ruhusa yaKuomba uwezo jina. UI siri ni urahisi; backend daima kutekeleza yake.
Uhalali waFungua ukurasa ulioripotiwa / node / uwanja, uirekebishe, kisha ufanyie upya.
Mgogoro wa migogoroReload marekebisho ya hivi karibuni, kulinganisha mabadiliko na reapply kwa makusudi. kamwe nguvu overwrite.
Kuondolewa / retryableWeka rasimu, kurejesha kuunganishwa, jaribu kupitia hatua na kuthibitisha hali ya kazi ya kudumu.
Uunganisho / usiowezekanaNakala ya kitambulisho uwiano na timestamp kwa msaada. Kamwe kuweka siri au maandishi binafsi ubaguzi.
Mwandishi wa kushindwaKutarajia kabla ya kuanza / kazi, retry tu hatua za kurejesha, au kurudi kwenye kutolewa kwa mwisho wenye afya.
SCIM 401/403Thibitisha mwisho / nafasi ya kazi, ishara ya kubeba, kuwezesha hali na mzunguko; kamwe kutumia kidakuzi cha kikao cha kivinjari.
Maarifa ni ya kutoshaThibitisha 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.