Tiedä mitä Studio omistaa
Portal Studio omistaa asiakaslähtöisen kuori: sivut, komponenttisijoittelu, merkki kuponkia, reagoiva käyttäytyminen, navigointi, alatunniste, lipunmyynti ja julkaisut. Help Center omistaa kieliä, luokat, osiot ja artikkelin sisältöä. Studyo kuluttaa sisällön kautta suojattu silta; se ei koskaan luo toista artikkelimyymälää.
Valmistaudu perusteellisesti ennen rakentamista
- Avaa Portaalistudio → Aloitus → Valmius.
- Vahvista kanoninen portaalin osoite ja avaa se erillisellä välilehdellä.
- Aseta logo, selain kuvake, kosketuskuvake, sosiaalinen kuva ja teeman väri.
- Vahvista Ohjekeskus kielet; muuttaa kieli auktoriteettia Tukikeskus, ei Studio.
- Määrittele navigointi ja globaali yritysalatunniste.
- Valitse matkalippu ja määritä vähintään yksi hakulomake.
- Pidä ainakin yksi turvallinen sisäänkirjautumismenetelmä aktiivisena ja tarkista henkilöllisyys.
- Suorita laatu ja vahvistaa allekirjoitettu esikatselu kädenpuristus.
- Luo ensimmäinen ohjattu julkaisu jokaisen eston jälkeen on selvä.
Valmiusprosentti lasketaan tallennetuista työtilatiedoista ja esikatselutilasta. Valitsemalla kohteen reitit suoraan sen omalle paneelille.
Koosta sivut ja uudelleen käytettävät osat
- Avaa Koosta → Sivuja ja valitse suojattu järjestelmä sivu tai luoda mukautettu sivu.
- Aseta reitti, otsikko, käyttötila ja paikallinen käyttäytyminen. Suojattuja järjestelmäreittejä ei voi poistaa.
- Avaa Osat, suodattaa työn tai kypsyyden mukaan ja sijoittaa komponentin yhteensopivaan lähtöpaikkaan.
- Tarkastajan on käytettävä sisältöä, ulkonäköä, sitovuutta, näkyvyyttä ja saavutettavuutta.
- Käytä uudelleenkäytettävissä kuvioita toistuvia rakenteita; pitää organisaatio-tai brändi eroja variantteja.
- Tallenna luonnos ja harjoitus lastaus, tyhjä, virhe, vieras ja kirjautunut tilassa esikatselu.
Esikatsella todellisia matkoja, ei yhtään iloinen näyttö
- Valitse vierastuki, sisäänkirjattu lippu, laskutus hoito, organisaatio tai tiedon luovutus.
- Vaihda persoonaa, organisaatiota, roolia ja Tukikeskus kieltä.
- Tutki mobiili, iso mobiile, tabletti, kannettava tietokone, työpöytä, laaja ja ultralaaja raja-arvot.
- Tarkista periytyvät, ylitykset ja nollausarvot; vältä tarpeetonta keskeytyspisteen päällekkäisyyttä.
- Suorita näppäimistö, RTL, alennettu-motion, lastaus, tyhjä, ei saatavilla ja lupa-tilassa.
- Käytä Test Lab-koetta ennen arviointia esteettömyys-, hyötykuorma-, reitti-, sitovuus- ja renderointihavaintoihin.
Käytä Zendesk-tason ohjekeskusta ilman kaksoissisältöä
- Luo luokat, osiot, artikkelit, käännökset, liitteet ja mallit Ohjekeskus.
- Käytä kieliä siellä; paikalliset etanat, haku, syötteet, SEO ja artikkeli kromi seuraavat samaa viranomaista.
- Studiossa on tietoa etsittävä, kategoria/resurssiruudukot, syötteet, aiheharmoniikka, artikkeli, sisältötaulukko, palaute, liittyvät ja aiemmat/seuraavat komponentit.
- Määrittele esillä olevat, suositut ja viimeaikaiset syötteet; käytä kontekstikohtaisia ehdotuksia lippuvirrassa.
- Esikatselu ei tuloksia, pitkiä artikkeleita, liitteet, palaute, katsella / tilaus ja lipun luovutuksesta.
- Varmista puhtaat paikalliset reitit, kanoniset/hreflangit, jäsennetyt tiedot ja välimuistin mitätöinti julkaisun jälkeen.
Aseta kirjautuminen turvallisesti
- Avaa Henkilöllisyys ja organisaatiot → Henkilöllisyys ja pitää vähintään yksi sisäänkirjautumistie käytössä.
- Valitse oletusmenetelmä, rekisteröintikäytäntö, istunnon kesto SSO-Poikkea valvonta- ja löytökäyttäytymisestä.
- Lisää palveluntarjoajia, joilla on näköreitityskentät: tyyppi, verkkotunnukset, prioriteetti, esitystapa, käytössä ja todennettu tila. Salaisuudet pysyvät tunnisteosajärjestelmässä.
- SCIM, ota käyttöön varaus, kopioi tarkka työtilan päätepiste ja pyöritä token. Tallenna kertaluonteinen polete IdP:ssä.
- Karttavaatimukset ja organisaation jäsenyys, sitten testi luoda, päivittää, ryhmän jäsenyys ja deaktivointi testi vuokralainen.
- Esikatseluvieras, asiakas, valtuutettu organisaatio ja estetty valtiot ennen julkaisemista.
Kokoa koko tukimatka
- Valitse suora muoto, velho, haku ensin, napa tai palvelu- desk merkintä.
- Luo nimetty, versioitu pyyntölomake osioiden ja saatavilla kenttätarroja.
- Rakenna visuaaliset olosuhteet, reititys, SLA ja hyväksymisvaiheet; JSON on vain tarkistettuja kehittäjän muutoksia.
- Määrittele luettelo, yksityiskohdat, lanka, aikajana, kiinnitys, hyväksyntä, SLA ja vastauspinnat.
- Koevieraan haku, sisäänkirjautuminen, organisaation näkyvyys, lataushäiriö, sähköpostin ilmoitus ja tiedon taipuma.
- Tallenna luonnos; julkaista vasta sen jälkeen, kun reittisovitin ja ilmoitusreitti läpäistä ennen lentoa.
Siirrä hallitun julkaisun läpi
- Suorita validointi ja Test Lab. Korjaa estohavainnot; tunnusta sallitut varoitukset asiayhteydestä.
- Lisää julkaisutiedotteet ja pyyntö tarkistaa. Arvioijat kommentoida vakaa sivu / solmupolkuja.
- Hyväksyjät tarkastavat erot, esikatselu matkoja, lupamuutokset ja todisteet.
- Julkaise tai aikataulu läpi taustatyöntekijä. Poistu Studio ei peruuta kestävää työtä.
- Seuraa edistymistä, terveyttä ja korrelaatiota. Pysäytä/eläkkeellä vain työnohjaajista.
- Varmista kriittiset reitit, henkilöllisyys, liput ja tieto. Palaa muuttumattomaan etukäteen vapautumiseen tarvittaessa.
| Voimavara | Aihe |
|---|---|
| Näytä / Muokkaa | Tutki tai muuta luonnoksia ilman julkaisuviranomaista. |
| Uudelleentarkastelu / hyväksyminen | Erillinen palaute ja hyväksyntä tekijältä. |
| Aikataulu / Julkaise / Palautus | Riippumaton tuotannon valvonta. |
| Henkilöllisyys / SCIM / Muuta / Komponentit / Diagnostiikka | Rajoita arkaluonteisia erikoistoimintoja. |
Siirrä todisteet ja paluumatka
- Valitse palveluntarjoajan suunnitelma ja luoda kuivaajo.
- Tarkistaa havaittu asetukset, kartantamattomat arvot, sisällön määrät ja visuaalinen pariteetti kaappaa.
- Täydellinen turvallinen kartoitus ja uudelleen jäsennelty diff.
- Hae luonnos, sovittaa yhteen laskenta ja esikatselu jokaisen suojatun matkan.
- Kirjaa hyväksytty hyväksyntä; älä koskaan korvaa nykyistä julkaistua julkaisua tuonnin aikana.
- Julkaise hallinnon avulla ja pidä muuttoliikeraportti, ID-tunnus ja kääntöpiste koossa.
Laajennetaan sopimuksia, ei malleja
Turvallinen laajennus rekisteröi vakaan komponenttityypin ja kaavan, ilmoittaa oikeudet ja tietotarpeet, tekee läpi kanoninen kääntäjä, ja toimittaa deterministiset kalusteet / testit. Älä kysele mielivaltaisia taulukoita, ruiskutus editori JavaScript julkiselle portaalille, luoda toinen artikkelivarasto, tai ohittaa julkaisuportti.
Portaaliasiakirja v2
Sivut sisältävät vakaita solmuja, lähtö- ja saapumisaikoja, ominaisuuksia, sidontoja, reagoivia ohituslaitteita, olosuhteita ja esteettömyysmetatietoja.
Osarekisteri
Yksi sopimus syöttää Studio, kääntäjä, dokumentointi, siirtymä- ja kypsyystarkastukset.
Tietolähderekisteri
Sallitut, vain luettavat, luvalliset DTO:t korvaavat mielivaltaisesti SQL Dynaamisia toimia.
Yksi renderöijä
Esikatselu ja julkinen tuotos jakaa kooste, manitifiointi, talousarviot ja runtime valtiot.
Määrittele komponenttipaketti
Käytä pienaakkosen nimeä ja semanttista versiota. Toimita sekä yhteensopivuusnimet, jotka on esitetty, koska pakettitarkastus ja turvatoimien validointi tekevät riippumattomia tarkastuksia.
{
"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}
}
Solmun muoto
{
"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"}
}
- Henkilöllisyydet pysyvät vakaina kaikissa editoissa ja siirtymissä.
- Ominaisuudet hylkää pimeät kentät ja turvaton HTML.
- Jokainen dataan perustuva näkymä määrittelee latauksen, tyhjän, luvan ja uudelleen yritettävissä olevan virhelähdön.
- Konttien osat nimeävät lähtö- ja saapumisaikansa; lehdet eivät voi hyväksyä mielivaltaisia lapsia.
- Merkitse kypsyys rehellisesti: suunnitellut lohkot, beeta varoittaa, GA vaatii täyden näytön.
Käytä käyttölupaturvallisia suojaverkkoja
- Valitse olemassa oleva katkottu tunnus, kuten
tickets.mine,knowledge.featuredtaicustomer.profile. - Sitokaa vain versioidun DTO:n ilmoittamat kentät. Tuntematon lähde epäonnistuu
data_source.unknown. - Ohita jo hyväksytty portaaliyhteys; älä koskaan hyväksy työtilaa/asiakas-identiteettiä luottamattomasta omaisuudesta.
- Listan raja-arvot on kiinnitetty1–100. Normalisoi pagination, locale ja hakuarvot.
- Jos uusi lähde on väistämätön, lisää sen vakaa määritelmä, turvallinen kartoitus, oikeudet, tyhjä käyttäytyminen ja esikatselu laite yhdessä.
{
"success": true,
"source": "tickets.mine",
"contract_version": 1,
"items": [
{"id": 42, "number": "REQ-42", "subject": "Example", "status": "open"}
]
}
Pysy luottamusrajojen sisällä
| Raja | Vaadittu käytös |
|---|---|
| Työtila | Selvitä luotettavasta isäntä / reitti / istunto, sitten tutkia jokaisen lukea ja kirjoittaa ennen suoritusta. |
| HTML | Käytä portaalin sanitizer/parser-lupalistaa. URLs, CSS tai käsikirjoitusta. |
| Esikatselu | Vaadi sama lähdeikkuna, allekirjoitettu kanavaversio ja nonce. Älä välitä ei-toivottuja viestejä. |
| Tunnistetiedot | Pidä salaisuuksia asiakirjojen ulkopuolella. SCIM on haltija-autentiticated, sessionless ja työtilaan sidottu. |
| Paketit | Hylätkää matka, absoluuttiset polut, linkit/erityistiedostot, arkistojen ylikoko, tarkistussumma/allekirjoitusero ja tuntemattomat käyttöoikeudet. |
| Virheet | Palauta vakaa koodi, turvallinen viesti, uudelleentryability, korjaus ja korrelaatio ID; loki yksityisiä poikkeuksia palvelimen puolella. |
| Tieto | Lue HelpCenterBridgen kautta. Älä koskaan kirjoita tai kopioi Ohjekeskus -artikkeleita laajennuksessa. |
{
"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"}
}
}
Tutki, asenna ja päivitä atomisesti
- Laita
component.jsonZIP-juurta ja pidä kaikki polut suhteellisina. - Suorita tarkastus ensin. Asentajan kansiot arkistot osoitteessa 500 merkinnät ja 25 MB outed; turvallisuusvarmennus lisää riippumattomia rajoja.
- Varmistetaan odotettu SHA-arvo 256 ja pakettien allekirjoitus julkaisuprosessissa.
- Asenna versioituun hakemistoon. Älä koskaan muuta asennettua versiota paikoilleen.
- Tarjoa kiinteistön muuttoja rikkoa skeema muutoksia ja säilyttää tuntematon yhteensopivuus kentät.
- Avaa osa luonnoksen, suorita jokainen valtion/näkymä / henkilö ja julkaista kautta hallinto.
- Rollback aktivoi aiemman muuttumattoman osan/asiakirjojen julkaisun; säilyttää sen uusittavissa olevat todisteet.
Todista laajennus sama julkaisu 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
Lähdeportit ovat välttämättömiä, eivät riittäviä. Liitä tietokanta/muutto, reaaliaikainen selain visuaalinen, identiteetti-palveluntarjoaja, valtuutus-eristys, saavutettavuus, suorituskyky, jono/cron, posti/kiinnitys, varmuuskopio/palautus ja käyttöönottotodisteet samaan muuttumattomaan julkaisuhasikseen. Tuntematon vaadittu näyttö ei saa olla release.
- Yksikkö: skeema, manitisaatio, DTO muoto, olosuhteet, vaellus ja kirjoittaa epäonnistumisia.
- Sopimus: lastaus/tyhjä/virhe/menestys, kypsyys, lähtö- ja saapumisajat sekä yhden käänteen pariteetti.
- Selain: näppäimistö, tarkennus, semantiikka, RTL, zoomaus/reflow, liikerajoitteet ja kaikki keskeytyspisteet.
- Turvallisuus: työtilojen rajat ylittävät luotaimet, väärennetyt toimet, pakettihyökkäykset, esikatselu spoofointi ja salainen vuoto.
- Toiminta: kestävä kehitys, loma/paluu, pysähdys/retry/resume, ajoittainen syke ja kääntyminen.
Vianmääritys tilan ja korrelaation ID:n mukaan
| Tila | Mitä tehdä? |
|---|---|
| Lupa | Pyydän nimetty kyky. Piilotettu käyttöliittymä on mukavuus; taustaosa aina valvoo sitä. |
| Validointi | Avaa raportoitu sivu/solmu/kenttä, korjaa se ja suorita lentoa edeltävät. |
| Konflikti | Lataa uusin versio uudelleen, vertaa muutoksia ja käytä niitä tahallaan. Älä koskaan pakota ylikirjoittamaan. |
| Offline / uudelleen työstettävä | Säilytä luonnos, palauttaa yhteydet, yrittää läpi toimen ja varmistaa kestävä työpaikkatila. |
| Kuolemaan johtanut / ei saatavilla | Kopioi korrelaatiotunnus ja aikaleima tukea. Älä liitä salaisuuksia tai yksityinen poikkeus teksti. |
| Julkaiseminen epäonnistui | Tutki ennen lentoa/työpaikkaa, yritä uudelleen vain uudelleen-vaiheessa tai siirry takaisin viimeiseen terveeseen julkaisuun. |
| SCIM 401/403 | Vahvista päätepiste/työtila, haltijatunnus, käytössä tila ja kierto; älä koskaan käytä selaimen istuntoevästettä. |
| Tieto on kulunutta. | Varmista paikallinen/julkaisu ohjekeskuksessa, tarkista välimuistin mitätöinti ja puhdas paikallinen reitti. |
Tämä opas on tulostusvalmis. Käytä Tulosta → Tallenna nimellä PDF Offline-kopiointi on valvottu.