← All dokumentasjon
Portal Studio felt guide

Bygg dristige. Publisher trygt

En praktisk referanse for administratorer som forme kundeopplevelsen og utviklerne som utvider den. Det dokumenterer den virkelige Studio arkitekturen, styret frigjøringssti, eiereskap i Hjelpsenteret, identitet, migranter, komponentkontrakter og gjenoppretting.

Portaldokument v2Administrator + UtviklerEnterprise release arbeidsflytOppdatert 1 August 2026
Administratorveiledning · Arkitektur

Vet hva Studio eier

Portal Studio eier det kundevendte skallet: sider, komponentplassering, merketegn, responsiv oppførsel, navigasjon, fotnote, identitetspresentasjonen, billettreiser og utgivelse. Hjelpsenteret eier språk, kategorier, seksjoner og artikkelinnhold. Studio bruker dette innhald gjennom en beskyttet bro; den skaper aldri et annet artiklerbutikk.

Hjelpesenter + billett + identitetstjenesterAdgangssikre dataadapterePortaldokument v2 utkastEn kompilator og regenererForhåndsvisning og publisering Portal
En-formidler regel: Forhåndsvisning og offentlige sider bruker samme dokument/kompilatorkontrakt. Publikasjon bytter aldri til en ikke-relatert mal.
Portal Studio · Arbeidsområdekart
Live lerretDesktop · Kunden
KundeportalDet samme strukturerte dokumentet som brukes i forhåndsvisning og offentlig rendring
Grensesnittkart: jobbskinnet, live lerret og inspektøren målrette samme stabile side-og nodevalg.
administratoren starter

Fullstendig klar før å bygge dypt

  1. Åpne Portal Studio → Start → Leselighet.
  2. Bekreft den kanoniske portaladressen og åpne det i en separat fane.
  3. Velg logo, nettleserikon og berøringsikonet.
  4. Bekreft Hjelp Center-språk; endre språkmyndighet i Help Centre, ikke Studio.
  5. Konfigurere navigasjon og den globale bedriftsfot.
  6. Velg billettreise og konfigurer minst ett forespørselsskjema.
  7. Hold minst én sikker logg-in metode aktiv og gjennomgang identitetsoppdagelse.
  8. Kjør kvalitet og etablere den signerte forhåndsvisningen håndtak.
  9. Opprett den første styrede utgivelsen etter at hver blokkeringselement er klart.

Forberedelsen er beregnet fra lagrede arbeidsområdedata og forhåndsvisning. Velger en elementrute direkte til sitt eiende panel.

Administrator · Bygg

Bygg sider og gjenbrukbare seksjoner

  1. Åpne Bygg → Sider og velg en beskyttet systemside eller lag egendefinert side.
  2. Sett ruten, tittelen og tilgangsmodus. Beskyttede systemruter kan ikke slettes.
  3. Åpne Komponenter, filtrer etter jobb eller modenhet og plasser en komponent i et kompatibelt spor.
  4. Bruk inspektøren for å ha det bra, utseendet og bindingene.
  5. Bruk gjenbrukbare mønstre for gjentatte strukturer; hold organisasjons- eller merkeforskjellene i varianter.
  6. Lagre utkastet til og trene lasting, tom, feil, gjeste-og logg inntilstander i forhåndsvisning.
Komponentbibliotek · Sanitisert grensesnittkart
KunnskapssøkGA · KundesikkerKategorinettGA · HjelpesenterArtikkelorganGA · oversatt DTOForespørselsskjemaGA · versjonTidslinje for billettBeta · advarselDatadiagramPlanlagte · blokker publisering
Grensesnittkart: kategori, kompatibilitet og modenhet er synlig før plassering. Planlagte komponenter blokkerer publikasjon; betakomponenter krever eksplisitt frigjøringsbehandling.
Administrator · Merke og responsiv

Forhåndsvisning av ekte reiser, ikke en lykkelig skjerm

  1. Velg gjestestøtte, innlogget billett, faktureringsservice, organisasjon eller kunnskapsavlevering.
  2. Bytt persona, organisasjon og hjelpesenter.
  3. Inspeksjon av mobil, stor mobil, nettbrett, bærbar datamaskin og skrivebord.
  4. Sjekk arvet, overstyrt og tilbakestilt verdier; unngå nåler bruddpunkt duplisering.
  5. Kjør tastatur, RTL, redusert bevegelse, lasting, tomme og ikke tilgjengelige tilstander.
  6. Bruk Test Lab for tilgjengelighet, nyttelast, rute- og bindingsfunn før gjennomgang.
Et grønt lerret er ikke en utgivelsesbeslutning. Styrte førfly, gjennomgang tilstanden, evnene og frigjøring bevis avgjør om portal kan publiseres.
Administrator · Erfaring

Operaer et Zendesk-nivå Hjelpesenteret uten duplisert innhold

  1. Opprett kategorier, seksjoner, artikler, oversettelser og maler i Hjelpesenter.
  2. Aktivere språk der; lokalisert sløver, søk, fôring SEO og artikkel krom følger den samme autoritet.
  3. I Studio, plasser kunnskapssøkefunksjonen, kategori/ressursnettene, fedmer, emne trekkspill, artikkel, tabell over innhold, tilbakemeldinger, beslektede og tidligere / nest komponenter.
  4. Konfigurer feed, populære og nylige fôr; bruk kontekstuelle forslag i billettflyt.
  5. Forhåndsvisning no-results, lange artikler, vedlegg, tilbakemeldinger og billettutlevering.
  6. Kontrollere rene lokale ruter, kanonisk / kjølig, strukturert data og cache ugyldigisering etter publisering.
Grensen til myndighet: Rediger artikkelinnhold og kundespråk i Hjelpesenter. Bruk Portal Studio bare for å komponere hvordan kunnskap oppdages og vises.
Administrator · Identifikasjon og organisasjoner

Konfigurer logg inn trygt

  1. Åpne Identifikasjon og organisasjoner → og holde minst én innsmeltningssti aktivert.
  2. Velg standardmetode, registreringsregler og sesjonsvarighet SSO- dominans håndhevelse og oppdagelse atferd.
  3. Legg til leverandører med visuelle rutefelt: type, domenene, prioriteten, presentasjonen, aktivert og verifisert tilstand. Hemligheter forblir i identitetsdelsystemet.
  4. For SCIM, aktiver levering, kopiere nøyaktig arbeidsområdet endepunkt og roter token. Lagre engangssymbolet i Idp.
  5. Kartkrav og organisasjonsmedlemskap, deretter test opprette, oppdatere, gruppe medlemskap og deaktivering med en prøveleier.
  6. Forhåndsvisning av gjest, kunde- og delegert organisasjon og blokkert stat før publisering.
Send aldri en Studio-øktsinformasjonskapsel til SCIM. Det er en sessionsløs, arbeidsområdebunden bærer API Roter et symbol etter utilsiktet eksponering.
Administrator · Billettreiser

Komponere hele støtteturen

  1. Velg direkte skjema, veiviseren, søke-første, nav eller tjenestedesk oppføring.
  2. Opprett et navngitt, versjonsbasert forespørselskjema med seksjoner og tilgjengelige feltetiketter.
  3. Bygg visuelle forhold, ruteruter, SLA og godkjenningstrinn; avansert JSON er kun for gjennomgått utviklerendring.
  4. Konfigurere liste, detaljer, tråd, tidslinje, vedlegg, godkjenning SLA og svar overflater.
  5. Test gjesteoppslag, logget inn forespurninger, organisasjonens synlighet, opplastingsfeil, e-postvarsling og kunnskap avbøyning.
  6. Lagre et utkast; publiser først etter ruteadapteren og varslingssti passerer forhånd.
Administrator · Gjennomgang og utgivelse

Flytt gjennom en styret utgivelse

Utkast lagretI anmeldelseGodkjentPlanlagt eller publisertObservert eller rullet tilbake
  1. Kjør validering og testlab. Fix blokkeringsfunn; bekreft tillatte advarsler med konteksten
  2. Legg til utgivelsesnotater og forespørselsanmeldelse. Gjennomgangere kommenterer stabil side/nodestier.
  3. Approwers inspiserer diff, forhåndsvisning av reiser, tillatelsesendring og bevis.
  4. Publisere eller planlegge gjennom bakgrunnsarbeideren. Leave Studio ikke avbryter en slitesterk jobb.
  5. Se på fremskritt, helse og korrelations-ID. Stopp/reparer bare fra jobbkontroll.
  6. Kontroller kritiske ruter, identiteten, billettene og kunnskap. Rull tilbake til en ugjennomtrengelig tidligere utgivelse når det kreves.
KapabilitetFormål
Vis / RedigerInspeksjon eller endring av utkast uten frigjøringsmyndighet.
Gjennomgå / godkjennSeparat tilbakemelding og godkjenning fra forfatterskap.
Planlegg / publisere/RollbackUavhengig produksjonskontroll.
Identitet / SCIM / Migrere / Komponentene / DiagnosticsBegrense sensitive spesialistoperasjoner.
Administrator · Migrer og forlenge

Migrer med bevis og en vei tilbake

  1. Velg leverandørens tegning og lag en tørr kjøre.
  2. Gjennomgang oppdaget innstillinger, ubebildede verdier og innholdstall i visuell paritet.
  3. Komplette sikre kartlegginger og omkjør den strukturerte diff.
  4. Bruk på et utkast, forene antall og forhåndsvisning av alle beskyttede reiser.
  5. Opptak autorisert aksept; overskriv aldri den gjeldende publiserte utgivelsen under import.
  6. Publiser gjennom styring og hold migrasjonsrapporten, frigi ID-og tilbaketrekkingspunkt sammen.
Utviklerutvidelsesguide · Arkitektur

Utvid kontrakter, ikke maler

En sikker utvidelse registrerer en stabil komponenttype og skjema, erklærer tillatelser og databehov, gjør gjennom den kanoniske kompilatoren. Leverer deterministiske fixturene/testene. Ikke spør vilkårlige tabeller, injiser redigering JavaScript inn i offentlig portal, opprette et annet artikkelarkiv eller omgå utgivelsesgaten.

Portaldokument v2

Sider inneholder stabile noder, spor, egenskaper, bindinger og responsive overstyringer.

Komponentregister

En kontrakt fôrer Studio, kompilatoren, dokumentasjon, migrasjon og modenhetskontroll.

Datakilderegister

Tillatt, skrivebeskyttet og autorisasjonsspekulert DTO erstatte vilkårlig SQL eller dynamiske handlinger.

En gjengivelsesperson

Forhåndsvisning og offentlig utgangsdeling, sanisering, budsjetter og løpstid.

Utvikler · Komponentkontrakt

Definer en komponentpakke

Bruk en liten navneområde ID og semantisk versjon. Lever både kompatibilitetsnavn vist fordi pakkekontroll-og sikkerhetsvalidering utfører uavhengig kontroller.

{
  "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}
}

Nodeform

{
  "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"}
}
  • ID-er forblir stabile på tvers av endringer og migrant.
  • Egenskaper avviser ikke-deklarerte felt og usikre HTML.
  • Hvert databundet vy definerer lasting, tom, tillatelse og gjenprøvbar feilutgang.
  • Beholderkomponenter navngir spilleautomatene; blader kan ikke akseptere vilkårlige barn.
  • Merk modenhet ærlig: planlagte blokker, beta advarer GA krever fullstendig bevis.
Utvikler · Datakilder og bindinger

Bruk autorisasjonssikre DTO-er

  1. Velg en eksisterende perforert ID som tickets.mine, knowledge.featured eller customer.profile.
  2. Bind bare felt erklært av sin versjon DTO. Ukjente kilder mislykkes med data_source.unknown.
  3. Pass den allerede autoriserte portal-konteksten; aksepter aldri arbeidsområde/kundeidentitet fra en upålitelig eiendom.
  4. Listegrensene er klemt til1–100 Normalisere paginasjon, lokal og søkeverdier.
  5. Hvis en ny kilde er uunngåelig, legg til sin stabile definisjon, sikker kartlegging, tillatelser og tom oppførsel samt forhåndsvisning av fixtur sammen.
{
  "success": true,
  "source": "tickets.mine",
  "contract_version": 1,
  "items": [
    {"id": 42, "number": "REQ-42", "subject": "Example", "status": "open"}
  ]
}
Datakilder er skrivebeskyttet. Mutasjoner krever en eksplisitt autorisert tjenestehandling, arbeidsområdebinding, CSRF/session eller bærevalidering, idemppotens der det trengs og et skrevet feilkonvolutt.
Utvikler · Sikkerhet

Hold deg innenfor tillitsgrensene

GrenserNødvendig oppførsel
ArbeidsplassLøs fra den betrodde verten/rute- / setning, så omfang hver lese og skrive før utføre.
HTMLBruk Portal sanitizer/parsere-lisenslisten. Aldri sammenstille upålitelige egenskaper, URLs, CSS eller manus.
ForhåndsvisningKreve samme kjeldekode, signert kanalversjon og ikke-selv. Ignorer uønskede meldinger.
IdentifikasjonBehold hemmeligheter utenfor dokumenter. SCIM er bærer-godkjent, øktløs og arbeidsområdebundet.
PakkerAvviser traversale, absolutte stier, lenker/særskild filer, overstørrelse arkivene, kontrollsum / signaturmangel og ukjent tillatelse.
FeilReturn stabil kode, sikker melding, reprøyabilitet, utbedring og korrelasjons-ID; logge private unntak serversiden.
KunnskapLes via HelpCenterBridge. Aldri forfatter eller duplisert Hjelp Center artikler i en utvidelse
{
  "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"}
  }
}
Utvikler · Pakke og migrasjon

Inspeksjon, installer og oppgrader atomisk

  1. Sett component.json ved ZIP-roten og holde alle veier i slekt.
  2. Kjør inspeksjon først. Installatøren tar arkiv på 500 oppføringer og 25 MB ekstrahert; sikkerhetsvalidering legger til uavhengige grenser.
  3. Bekreft forventet SHA-256 og pakkesignatur i utgivelsesprosessen.
  4. Installer i en versjonsmappe. Aldri muta den installerte versjonen på plass.
  5. Gi eiendomsmigrasjoner for å bryte skjemaendringene og bevare ukjente kompatibilitetsfelt.
  6. Åpne komponenten i et utkast, kjøre hver stat/visning / persona fixture og publisere gjennom styring.
  7. Rollback aktiverer den tidligere immutable komponenten/dokument frigivelse; behold dets reproducabilitet bevis.
Utvikler · Tester og utgivelse

Bevis forlengelsen på samme frigjøring 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

Kildeporter er nødvendig, ikke tilstrekkelig. Legg til database/innvandring, ekte nettlesere visuelt, identitetsleverandør, autorisasjon-isolering, tilgjengelighet, ytelse, kø / krone, post/attachment, sikkerhetskopierings - og utplasseringsbevis for den samme immutable frigivelse hash. Ukjent nødvendige bevis må mislykkesutgivelsen.

  • Enhet: skjema, sanisering, DTO form, betingelser, migrasjoner og skrivne feil.
  • Kontrakt: lasting/tomm / feil/lykker, modenhet, spor, bindinger og en-formidler paritet.
  • Nettleser: tastatur, fokus, semantikk, RTL, zoom/recflow, redusert bevegelse og hvert pausepunkt.
  • Sikkerhet: tverrarbeidssonder, smidd handling, pakkeangrep og forhåndsvisning av spoofing.
  • Operasjoner: varig fremgang, lauv/return, stopp / forsøk på å gjenbruke eller planlegge hjerterytmen og tilbakerulling.
Administrator + Utvikler · Recovery

Feilsøk etter tilstand og korrelasjon ID

TilstandHva skal jeg gjøre
TilgangBe om den navngitte funksjonen. Skjult UI er bekvemmelighet; bakstykket alltid håndhever det.
ValideringÅpne den rapporterte siden/node / feltet, rett det og kjør deretter om før.
KonfliktLast den siste revisjonen på nytt, sammenlikn endringer og bruk med vilje. Du må aldri overskrive det.
Frakoblet / reprøvbarHold utkastet, gjenopprett tilkoblingsenhet, prøv igjen gjennom handlingen og verifisere holdbar jobbtilstand.
Dødlig / utilgjengeligKopier korrelasjons-ID og tidsstempler for støtte. Aldri lim inn hemmeligheter eller privat unntak tekst.
Publisering mislykkesInspeksjon av forflytning/jobbutgang, reprøv bare omprøves stadier eller rull tilbake til den siste sunne utgivelsen.
SCIM 401/403Bekreft endepunkt/arbeidsrom, bæretegn, aktivert tilstand og rotasjon; bruk aldri en nettleserøktskapsler.
Kunnskap er stabiltKontroller lokalisering/Juster i Hjelpesenteret, inspisere deretter cache-ugyldiggjøring og den rene lokale ruten.

Denne guiden er print- ready. Bruk Skriv ut → Lagre som PDF for en kontrollert offline kopi.