← Wszystkie dokumenty
Portal Studio przewodnik po polu

Zbuduj śmiało, wydaj bezpiecznie.

Jeden praktyczny punkt odniesienia dla administratorów kształtujących doświadczenie klienta i deweloperów, którzy go rozszerzają. Dokumentuje on prawdziwą architekturę Studio, ścieżkę wydania regulowaną, własność Centrum Pomocy, tożsamość, migracje, kontrakty komponentów i odzyskiwanie.

Portal dokumentu v2Administrator + programistaPrzepływ pracy w zakresie uwalniania przedsiębiorstwAktualizacja 1 Sierpień 2026
Przewodnik dla administratorów · Architektura

Wiesz, co Studio posiada

Portal Studio posiada powłokę zwróconą do klienta: strony, umieszczenie komponentu, znaki marki, zachowanie reagujące, nawigacja, stopka, prezentacja tożsamości, podróże biletów i wydania. Centrum pomocy posiada języki, kategorie, sekcje i zawartość artykułu. Studio konsumuje tę treść przez chroniony most; nigdy nie tworzy drugiego sklepu artykułów.

Pomoc Centrum + bilet + usługi tożsamościDostosowacze danych o bezpieczeństwieProjekt dokumentu portalu v2Jeden kompilator i rendererPodgląd i opublikowany portal
Zasada jednego z rendererów: Podgląd i strony publiczne używają tego samego dokumentu / umowy kompilatora. Publikacja nigdy nie przełącza się na niepowiązany szablon.
Portal Studio · Mapa miejsca pracy
Płótno żyweDesktop · Klient
Portal klientaTen sam dokument strukturalny stosowany w podglądzie i publicznej renderowaniu
Mapa interfejsu: szyna pracy, płótno i inspektor mają do wyboru tę samą stabilną stronę i węzeł.
Administrator · Zaloguj się

Pełna gotowość przed głębokim budową

  1. Otwórz Portal Studio → Start → Ciepłość.
  2. Potwierdź adres kanoniczny portalu i otwórz go w osobnej zakładce.
  3. Ustaw logo, ikonę przeglądarki, ikonę dotyku, wizerunek społeczny i kolor motywu.
  4. Potwierdź języki Help Center; zmień autorytet językowy w Help Centre, nie Studio.
  5. Skonfiguruj nawigację i globalną stopę przedsiębiorstwa.
  6. Wybierz podróż biletu i skonfiguruj co najmniej jeden formularz wniosku.
  7. Należy zachować co najmniej jeden bezpieczny sygnał w metodzie aktywnego i przeglądu tożsamości.
  8. Uruchom Jakość i ustal podpisane podpowiedzi handshake.
  9. Utwórz pierwsze regulowane wydanie po każdym zablokowaniu jest jasne.

Procent gotowości oblicza się z zapisanych danych i stanu podglądu. Wybór trasy elementu bezpośrednio do jego panelu posiadania.

Administrator · Budowanie

Tworzenie stron i sekcje wielokrotnego użytku

  1. Otwórz Budowanie → Strony i wybrać stronę systemu chronionego lub utworzyć własną stronę.
  2. Ustaw trasę, tytuł, tryb dostępu i zachowanie locale. Chronione trasy systemowe nie mogą być usunięte.
  3. Otwórz Elementy, filtrować według pracy lub dojrzałości i umieścić komponent w kompatybilnym szczelinie.
  4. Używaj inspektora do tworzenia treści, wyglądu, wiązania, widoczności i dostępności.
  5. Używać wzorów wielokrotnego użytku dla powtarzających się struktur; zachować różnice organizacyjne lub marki w wariantach.
  6. Zapisz projekt i ćwiczenia ładowania, puste, błąd, gość i signed- w stanach w podglądzie.
Biblioteka komponentów · Mapa interfejsów skażonych
Poszukiwanie wiedzyGA · bezpieczeństwo klientaSieć kategoriiGA · Centrum pomocyOrganGA · przetłumaczone DTOFormularz wnioskuGA · wersjaTerminy biletówBeta · ostrzeżenieSchemat danychPlanowane · bloki publikują
Mapa interfejsu: przed umieszczeniem widoczne są kategorie, kompatybilność i dojrzałość. Planowana publikacja blokowa komponentów; komponenty beta wymagają wyraźnego zwolnienia.
Administrator · Marka i reagujący

Podgląd prawdziwych podróży, ani jednego szczęśliwego ekranu

  1. Wybierz wsparcie gości, signed- w bilecie, usługi rozliczeniowe, organizacja lub przekazanie wiedzy.
  2. Przełącz personas, organizację, rolę i Pomoc Center język.
  3. Sprawdź mobilne, duże mobilne tablety, laptopy, pulpit, szerokie i ultraszerokie punkty graniczne.
  4. Sprawdź wartości odziedziczone, przekroczone i zresetowane; unikaj niepotrzebnego powielania punktów zerwania.
  5. Uruchom klawiaturę, RTL, reduced- motion, ładowanie, puste, niedostępne i zezwolenia stany.
  6. Przed przeglądem należy wykorzystać test Lab do uzyskania dostępności, ładunku, trasy, wiązania i renderowania.
Zielone płótno nie jest decyzją o wydaniu. Utrzymany przed lotem, stan przeglądu, możliwości i wydanie dowodów zdecydować, czy Portal może opublikować.
Administrator · Doświadczenie

Uruchom centrum pomocy na poziomie Zendesk- bez duplikatu treści

  1. Tworzenie kategorii, sekcji, artykułów, tłumaczeń, załączników i szablonów w Centrum pomocy.
  2. Włącz tam języki; zlokalizowane ślimaki, wyszukiwanie, kanały, SEO i chrom artykułu podążają za tym samym autorytetem.
  3. W Studio, wyszukiwania wiedzy o miejscu, kategorii / sieci zasobów, kanałów, akordeon tematu, artykuł, tabela treści, opinie, powiązane i poprzednie / następne komponenty.
  4. Konfiguracja wyświetlanych, popularnych i ostatnio dostępnych kanałów; wykorzystanie sugestii kontekstowych w przepływach biletów.
  5. Podgląd wyników, długich artykułów, załączników, informacji zwrotnych, zegarków / subskrypcji i przekazania biletów.
  6. Sprawdzić czyste trasy lokalne, kanoniczne / hreflang, dane ustrukturyzowane i unieważnienie pamięci podręcznej po publikacji.
Granica uprawnień: edytuj zawartość wiadomości i języki klienta w Centrum Pomocy. Użyj Portal Studio tylko do komponowania jak wiedza jest odkrywana i wyświetlana.
Administrator · Tożsamość i organizacje

Konfiguracja sygna-in bezpiecznie

  1. Otwórz Tożsamość i organizacje → Tożność i utrzymać co najmniej jeden znak na ścieżce włączone.
  2. Wybierz metodę domyślną, politykę rejestracji, czas trwania sesji, SSO- egzekwowanie domeny i zachowanie odkrywania.
  3. Dodawanie dostawców z polami routingu wizualnego: typ, domeny, priorytet, prezentacja, stan włączony i zweryfikowany. Tajemnice pozostają w podsystemie tożsamości.
  4. Dla SCIM, włącz tworzenie rezerw, skopiuj dokładny punkt końcowy przestrzeni roboczej i obróć token.
  5. Mapy roszczeń i członkostwa w organizacji, następnie test tworzenia, aktualizacji, członkostwo grupy i deaktywacji z najemcą testowym.
  6. Przed publikacją można obejrzeć gości, klientów, organizację delegowaną i zablokowane państwa.
Nigdy nie wysyłaj plików cookie sesji Studio do SCIM Jest to bezsesyjny, związany z pracą okaziciel API. Obrócić token po przypadkowym ekspozycji.
Administrator · Podróże biletami

Utwórz pełną podróż wsparcia

  1. Wybierz bezpośredni formularz, kreatora, wyszukiwarkę - pierwszy, punkt lub miejsce na biurku.
  2. Utwórz nazwany, zmodyfikowany formularz wniosku z sekcjami i dostępnymi etykietami pola.
  3. Zbuduj warunki wizualne, routing, SLA i etapy zatwierdzania; zaawansowane JSON jest tylko dla zrewidowanych zmian deweloperskich.
  4. Konfiguracja listy, szczegółów, wątku, linii czasu, mocowania, zatwierdzenia, SLA i powierzchni odpowiedzi.
  5. Sprawdzić, czy gość jest w stanie sprawdzić, czy nie ma żadnych żądań, widoczności organizacji, niepowodzenia wysyłania wiadomości e-mail i odchylenia wiedzy.
  6. Zapisz projekt; publikować tylko po adapterze trasy i ścieżka powiadomienia przejść przed lotem.
Administrator · Przegląd i wydanie

Przesuń przez sterowane wydanie

Projekt zapisanyW trakcie przegląduZatwierdzoneZaplanowany lub opublikowanyZaobserwowane lub zwinięte
  1. Uruchom walidację i test Lab. Napraw ustalenia blokujące; uznać dozwolone ostrzeżenia z kontekstem.
  2. Dodaj notatki wydania i recenzję prośby. Recenzenci komentarz na stabilnej stronie / ścieżkach węzłów.
  3. Aprobatorzy sprawdzają różnice, podgląd podróży, zmiany pozwolenia i dowodów.
  4. Publikuj lub rozpisuj przez pracownika tła. Opuszczenie Studio nie anuluje trwałego zatrudnienia.
  5. Obserwuj postęp, zdrowie i identyfikator korelacji. Zatrzymaj / ponownie tylko z kontroli pracy.
  6. Sprawdź krytyczne trasy, tożsamość, bilety i wiedzę. Wznawiaj z powrotem do niezmiennego wcześniejszego wydania, gdy jest to wymagane.
ZdolnośćCel
Widok / EdycjaSprawdzić lub zmienić projekty bez upoważnienia do wydania.
Przegląd / zatwierdzenieOddzielne informacje zwrotne i zatwierdzenie od autora.
Harmonogram / Publish / RollbackNiezależne kontrole produkcji.
Tożsamość / SCIM / Migracja / Składniki / DiagnostykaZakaz wrażliwych operacji specjalistycznych.
Administrator · Migracja i rozszerzenie

Migracja z dowodami i sposobem powrotnym

  1. Wybierz projekt dostawcy i utworzyć suchy bieg.
  2. Przegląd odkrytych ustawień, nieodwzorowanych wartości, ilości treści i wizualne ujęcia parytetu.
  3. Kompletne bezpieczne mappings i ponownie uruchomić ustrukturyzowany diff.
  4. Stosować do szkicu, godzić się liczy i podgląd każdej chronionej podróży.
  5. Zapis autoryzowanej akceptacji; nigdy nie nadpisz bieżącego publikowanego wydania podczas importu.
  6. Publikować poprzez zarządzanie i przechowywać raport migracji, wydać ID i punktów zwrotnych razem.
Przewodnik po rozszerzeniu dewelopera · Architektura

Rozwijanie kontraktów, nie szablonów

Bezpieczne rozszerzenie rejestruje stabilny typ komponentu i schemat, deklaruje uprawnienia i potrzeby danych, renderuje za pośrednictwem kanonicznego kompilatora, a także dostarcza stabilnych elementów / testów. Nie zapytania arbitralne tabele, edytor wstrzyknięć JavaScript do portalu publicznego, tworzenia innego repozytorium artykułów lub omijania bramy wydania.

Portal dokumentu v2

Strony zawierają stabilne węzły, szczeliny, właściwości, wiązania, reagujące nadjazdy, warunki i metadane dostępności.

Rejestr komponentów

Jedna umowa karmi Studio, kompilator, dokumentacja, migracja i dojrzałość kontroli.

Rejestr źródeł danych

Dopuszczalne, tylko do odczytu, DTO z opcją oceny zastępują arbitralne SQL lub działania dynamiczne.

Jeden najemca

Podgląd i public output skompilowanie, oczyszczanie, budżety i stany w czasie pracy.

Deweloper · Kontrakt komponentów

Określić pakiet komponentów

Użyj małego rozmiaru nazwy w wersji ID i semantycznej. Dostarcz zarówno nazwy właściwości kompatybilności, które zostały pokazane, ponieważ kontrola pakietu i walidacja zabezpieczeń przeprowadzają niezależne kontrole.

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

Kształt węzła

{
  "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"}
}
  • Identyfikatory pozostają stabilne w czasie edycji i migracji.
  • Właściwości odrzucają nierejestrowane pola i niebezpieczne HTML.
  • Każdy widok związany z danymi definiuje wczytywanie, opróżnianie, pozwolenie i wyjście błędu.
  • Składniki kontenera nadają nazwę swoim szczelinom; liście nie mogą przyjmować arbitralnych dzieci.
  • Zaznacz dojrzałość szczerze: planowane bloki, beta ostrzega, GA wymaga pełnego dowodu.
Programista · Źródła danych i wiązania

Użyj DTO-bezpieczny

  1. Wybierz istniejący identyfikator kropkowany, taki jak tickets.mine, knowledge.featured lub customer.profile.
  2. Związane tylko pola zadeklarowane przez jego modyfikowane DTO. Nieznane źródła nie powiodły się z data_source.unknown.
  3. Podaj już autoryzowany kontekst Portal; nigdy nie akceptuj tożsamości klienta / miejsca pracy z niezaufanej nieruchomości.
  4. Limity listy są przymocowane do1–100. Normalizacja wartości paginacji, locale i wyszukiwania.
  5. Jeśli nowe źródło jest nieuniknione, dodaj jego stabilną definicję, bezpieczne mapowanie, uprawnienia, puste zachowanie i podgląd oprawy razem.
{
  "success": true,
  "source": "tickets.mine",
  "contract_version": 1,
  "items": [
    {"id": 42, "number": "REQ-42", "subject": "Example", "status": "open"}
  ]
}
Źródła danych są tylko read-. Mutacje wymagają wyraźnego autoryzowanego działania usługowego, wiązania z miejscem pracy, weryfikacji CSRF / sesji lub na okaziciela, idepotencji w razie potrzeby i koperty błędów wpisanych.
Programista · Bezpieczeństwo

Zostań w granicach zaufania.

GranicaWymagane zachowanie
Przestrzeń roboczaRozwiązanie z zaufanego hosta / trasy / sesji, następnie zakres każdego odczytu i zapisu przed wykonaniem.
HTMLUżywaj portala do czyszczenia / parser allowlist. Nigdy nie konkatenuuj niezaufanych atrybutów, URLs, CSS lub scenariusz.
PodglądWymagane jest samo-pochodzenie okna źródłowego, podpisane wersje kanału i nonce. Ignoruj niezamówione wiadomości.
TożsamośćSCIM jest beorer- uwierzytelniony, bez sesji i pracy-space.
PakietyOdrzucenie przechodzenia, ścieżki bezwzględne, linki / pliki specjalne, archiwa o rozmiarach nadrzędnych, niedopasowanie sumy kontrolnej / podpisu i nieznane uprawnienia.
BłędyZwróć stabilny kod, bezpieczną wiadomość, możliwość regeneracji, korektę i identyfikator korelacji; zaloguj prywatne wyjątki po stronie serwera.
WiedzaCzytaj poprzez HelpCenterBridge. Nigdy nie pisz ani nie duplikuj artykułów Centrum Pomocy w rozszerzeniu.
{
  "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"}
  }
}
Programista · Pakiet i migracja

Sprawdzić, zainstalować i uaktualnić atomicznie

  1. Umieść component.json przy korzeniu ZIP i zachować każdą ścieżkę względną.
  2. Uruchom najpierw inspekcję. Instalator caps archiwa w 500 wpisy oraz 25 MB ekstrahowane; walidacja bezpieczeństwa dodaje niezależne limity.
  3. Weryfikacja oczekiwanego SHA-256 i podpisu pakietu w procesie wydania.
  4. Instaluj do katalogu z wersją. Nigdy nie mutuj zainstalowanej wersji na miejscu.
  5. Zapewnić migracje nieruchomości do łamania zmian schematów i zachować nieznanych pól kompatybilności.
  6. Otwórz element w projekcie, uruchom każdy stan / punkt widzenia / personal i opublikuj za pośrednictwem zarządzania.
  7. Rollback aktywuje wcześniejsze nieskazitelne zwolnienie komponentu / dokumentu; zachowuje swoje dowody odtwarzalności.
Programista · Testy i uwolnienie

Udowodnij rozszerzenie na tym samym haszu wydania

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

Bramy źródłowe są niezbędne, nie wystarczy. Dołącz bazę danych / migrację, real- browser wizualny, identyfikator-dostawca, autoryzacja- izolacja, dostępność, wydajność, kolejka / cron, mail / załącznik, kopię zapasową / przywracanie i wprowadzenie dowodów do tego samego niezmiennego haszu wydania. Nieznany wymagany dowód musi nie doprowadzić do wydania.

  • Jednostka: schemat, sanityzacja, kształt DTO, warunki, migracje i błędy na maszynie.
  • Kontrakt: załadunku / pustego / błędu / sukcesu, dojrzałości, szczeliny, wiązania i jednorenderowania parytetu.
  • Przeglądarka: klawiatura, ostrość, semantyka, RTL, zoom / reflep, redukcja ruchu i każdy punkt przełomowy.
  • Bezpieczeństwo: sondy przestrzeni roboczej, podrobione działania, ataki pakietów, podgląd wyciek i tajny.
  • Operacje: trwały postęp, urlop / powrót, zatrzymanie / ponowna próba / wznowienie, tętno i zwroty.
Administrator + programista · Odzyskiwanie

Rozwiązywanie problemów według stanu i ID korelacji

PaństwoCo robić
ZezwoleniePoproś o nazwaną zdolność. Ukryty interfejs jest wygodą; backend zawsze go wzmacnia.
WalidacjaOtwórz stronę / węzeł / pole, poprawij je, a następnie ponownie uruchom przed lotem.
KonfliktWczytaj najnowszą wersję, porównuj zmiany i ponownie zastosuj umyślnie. Nigdy nie wymusz nadpisywania.
Offline / retryZachowaj projekt, przywróć łączność, ponownie przećwicz działanie i zweryfikuj stan pracy.
Śmiertelne / niedostępneKopiuj identyfikator korelacji i znacznik czasu dla wsparcia. Nigdy nie wklej sekretów lub tekstu prywatnego wyjątku.
Publikuj nieudanySprawdź wyjście przed lotem / pracą, ponownie spróbować tylko do ponownego testowania etapów lub wrócić do ostatniego zdrowego wydania.
SCIM 401/403Potwierdź punkt końcowy / miejsce pracy, token na okaziciela, stan włączony i rotacja; nigdy nie używaj cookie sesji przeglądarki.
Wiedza jest nieświeżaSprawdź locale / publikacja w Centrum Pomocy, a następnie sprawdź unieważnienie cache i czyste trasy zlokalizowane.

Ten przewodnik jest print- ready. Użyj Drukuj → Zapisz jako PDF do kontrolowanej kopii offline.