> ## Documentation Index > Fetch the complete documentation index at: https://www.twicecommerce.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Näkyvät alueet > Näkyvät alueet ja välilehtikohtainen piilotus määrittävät, mitkä osiot ja välilehdet näkyvät Adminissa — tietojen käyttöoikeuksista riippumatta. **Näkyvät alueet** määrittävät, mitkä ylätason osiot näkyvät Adminin sivupalkissa kullekin roolille. **Piilotetut välilehdet** laajentavat tämän yksittäisiin sivun sisäisiin välilehtiin — rooli voi piilottaa osion sisältä tiettyjä välilehtiä poistamatta itse osiota. Molemmat ovat riippumattomia tietojen käyttöoikeuksista. ## Miten se toimii Jokaisella roolilla — järjestelmäroolilla tai mukautetulla — on kaksi erillistä kenttää: * **Käyttöoikeudet** — palvelimella valvottu tietojen käyttö. Määrittää, mitä API palauttaa käyttäjälle. Esimerkki: `customers:view` antaa käyttäjän lukea asiakastietoja. * **Näkyvät alueet** — käyttöliittymän näkyvyys asiakaspäässä. Määrittää, mitkä osiot näkyvät Adminin sivupalkissa ja ovat saavutettavissa URL-osoitteella. Esimerkki: `customers` kentässä `visibleAreas` näyttää Asiakkaat-välilehden. Nämä kaksi ulottuvuutta ovat riippumattomia. Käyttäjällä voi olla `customers:view`-oikeus (tukemaan resurssien välisiä työnkulkuja, kuten tilauksen asiakasvalitsinta) ilman, että Asiakkaat-osio näkyy sivupalkissa. ### Epäsymmetrinen sääntö Näkyviin alueisiin sovelletaan yhtä suuntaista rajoitusta: * **Alueen näyttäminen pakottaa tietojen käytön.** Jos `customers` on kentässä `visibleAreas`, roolilla on oltava myös `customers:view`-oikeus. Käyttöoikeusmatriisi valvoo tätä automaattisesti — alueen näkyvyyden käyttöönotto lisää `:view`-oikeuden, jos se puuttuu. * **Tietojen käyttö ei pakota näkyvyyttä.** Oikeuden `customers:view` myöntäminen ei lisää `customers`-aluetta automaattisesti kenttään `visibleAreas`. Sivupalkki pysyy ennallaan. Näin voit rakentaa rooleja kuten ”tilausvastaava, jolla on pääsy asiakastietoihin mutta ei Asiakkaat-välilehteä” — käyttäjä voi valita asiakkaita tilausprosessin sisällä näkemättä erillistä Asiakkaat-osiota sivupalkissa. ### Ratkaisu useiden roolien kesken Käyttäjän tosiasialliset näkyvät alueet ovat kaikkien liitettyjen roolien **yhdiste** — järjestelmärooli sekä mahdolliset mukautetut roolit. Jos mikä tahansa rooli sisältää alueen, alue näkyy sivupalkissa. ```json Esimerkki lopputuloksesta theme={null} { "system_role": "member", "system_role_visible_areas": [ "tasks", "inventory", "catalog", "orders", "customers", "online_store" ], "custom_roles": [ { "name": "Finance Viewer", "visible_areas": ["finance"] } ], "effective_visible_areas": [ "tasks", "inventory", "catalog", "orders", "customers", "online_store", "finance" ] } ``` Member-järjestelmärooli ei sisällä oletuksena aluetta `finance`, mutta mukautettu ”Finance Viewer” -rooli lisää sen. Käyttäjä näkee kaikki seitsemän osiota. ### Käytettävissä olevat alueet Näkyvät alueet vastaavat yksi yhteen Adminin ylätason resursseja: | Alue | Sivupalkin osio | | :------------------ | :----------------------------------- | | `tasks` | Tehtävät | | `inventory` | Inventaario | | `catalog` | Katalogi | | `orders` | Tilaukset | | `customers` | Asiakkaat | | `online_store` | Verkkokauppa (ja muut myyntikanavat) | | `reports` | Raportit | | `location_settings` | Sijaintien asetukset | | `account_settings` | Tilin asetukset | | `finance` | Talous | ### Välilehtikohtainen näkyvyys Kokonaisten sivupalkin osioiden piilottamisen lisäksi roolit voivat piilottaa osion sisältä yksittäisiä **välilehtiä**. Jokaisella roolilla on `hiddenTabs`-lista — taulukko `resource:subResource`-avaimia, jotka kertovat, mitkä välilehdet piilotetaan. Välilehdet noudattavat **leikkauksen** (JA) logiikkaa, joka on näkyvien alueiden käänteinen: * **Näkyvät alueet** käyttävät yhdistettä — mikä tahansa alueen näyttävä rooli voittaa. * **Piilotetut välilehdet** käyttävät leikkausta — välilehti on piilotettu vain, jos **jokainen** käyttäjälle liitetty rooli piilottaa sen. Jos mikä tahansa rooli jättää välilehden näkyviin, se näkyy. Sallivampi rooli voittaa siis aina: roolin lisääminen ei koskaan piilota välilehteä, jonka toinen rooli näyttää. ```json Esimerkki leikkauksesta theme={null} { "roles": [ { "name": "Warehouse Lead", "hiddenTabs": ["orders:order_payments", "orders:order_documents"] }, { "name": "Returns Handler", "hiddenTabs": ["orders:order_payments"] } ], "effective_hidden_tabs": ["orders:order_payments"] } ``` Molemmat roolit piilottavat avaimen `orders:order_payments`, joten se pysyy piilossa. Vain toinen rooli piilottaa avaimen `orders:order_documents`, joten Dokumentit-välilehti näkyy. ### Piilotettavat välilehdet Jokainen Adminin välilehti tunnistetaan `resource:subResource`-avaimella. Koko joukko kattaa kaikki keskeiset alueet: | Resurssi | Esimerkkivälilehdet | | :--------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **orders** | `order_summary`, `order_line_items`, `order_customers`, `order_stock_items`, `order_fulfillment`, `order_payments`, `order_comments`, `order_documents`, `order_activity_log` | | **catalog** | `listing_general`, `listing_attributes`, `listing_variants`, `listing_price`, `listing_limits`, `listing_fulfilment`, `listing_checkout`, `listing_seo`, `listing_documents`, `listing_orders_log`, `listing_activity_log`, `collection`, `collection_listings`, `collection_seo`, `price_table`, `discount` | | **inventory** | `stock_item_general`, `stock_item_attributes`, `stock_item_cost`, `stock_item_fulfilment`, `stock_item_documents`, `stock_item_events`, `sku_general`, `sku_attributes`, `sku_stock_items`, `sku_documents` | | **customers** | `customer_general`, `customer_attributes`, `customer_documents`, `customer_orders`, `customer_listings`, `customer_stock_items` | | **online\_store** | `editor`, `default_content`, `settings` | | **location\_settings** | `contact_info`, `opening_hours`, `sales_channels`, `document` | | **account\_settings** | `business_details`, `general`, `brand`, `payment`, `policies`, `taxes`, `users_and_roles`, `notifications`, `languages`, `translations`, `integrations`, `domain`, `checkout`, `documents`, `file_manager`, `security` | | **reports** | `sales_report`, `tax_report` | | **finance** | `subscription_plan`, `billing` | Jokaiseen avaimeen liitetään API:ssa sen resurssi etuliitteeksi (esimerkiksi `orders:order_payments`). Adminin käyttöoikeusmatriisi näyttää ne resursseittain ryhmiteltyinä ja luettavilla nimillä varustettuina. Käyttöoikeusmatriisi välilehtikohtaisine Show in UI -valintaruutuineen ### Järjestelmäroolien oletukset Jokaisella järjestelmäroolilla on ennalta määritetty joukko näkyviä alueita: | Järjestelmärooli | Näkyvät alueet | | :--------------- | :--------------------------------------------------------------------- | | **Owner** | Kaikki 10 aluetta | | **Admin** | Kaikki paitsi `finance` | | **Manager** | Kaikki paitsi `account_settings` ja `finance` | | **Member** | `tasks`, `inventory`, `catalog`, `orders`, `customers`, `online_store` | Mukautetut roolit voivat laajentaa näitä oletuksia lisäämällä alueita, joita järjestelmärooli ei sisällä. Järjestelmäroolit eivät piilota oletuksena yhtään välilehteä — kaikki välilehdet ovat näkyvissä. Välilehtikohtainen piilotus määritetään vain mukautetuilla rooleilla. ## Käyttö ### Näkyvyyden määritys käyttöoikeusmatriisissa Kun luot tai muokkaat mukautettua roolia, käyttöoikeusmatriisi näyttää **Show in UI** -sarakkeen tietojen käyttösarakkeiden (View, Create, Manage, Delete) rinnalla. Sarakkeessa on kaksi tasoa valintaruutuja: * **Ylätason rivi** — ohjaa sivupalkin osiota (näkyvää aluetta). Sen kytkeminen päälle tai pois näyttää tai piilottaa koko osion. * **Aliresurssien rivit** — ohjaavat osion yksittäisiä välilehtiä. Laajentamalla ylätason rivin näet välilehtikohtaiset valintaruudut. Matriisi valvoo epäsymmetristä sääntöä molemmilla tasoilla: Show in UI -asetuksen kytkeminen päälle ottaa automaattisesti käyttöön kyseisen resurssin tai välilehden View-oikeuden. View-oikeuden poistaminen poistaa automaattisesti Show in UI -asetuksen. ### Kun näkyvyys on piilotettu mutta tietojen käyttö säilyy Piilotettu alue tai välilehti ei estä resurssien välisiä työnkulkuja. Yleisiä tilanteita: * **Asiakasvalitsin tilauksissa** — rooli, jolla on `customers:view` mutta ei aluetta `customers` näkyvissä, voi silti hakea ja valita asiakkaita tilausta luodessaan. Asiakkaat-osio on piilossa, mutta valitsin toimii. * **Piilotettu välilehti, näkyvä data** — avaimen `orders:order_payments` piilottaminen poistaa Maksut-välilehden tilauksen tietosivulta, mutta maksutiedot kulkevat edelleen muissa näkymissä (esimerkiksi tilauksen yhteenvedon summissa ja raporteissa). * **Suorat linkit** — linkki suoraan piilotetun alueen URL-osoitteeseen näyttää käyttöoikeussivun. Tietojen käyttöoikeus pätee edelleen palvelimella, mutta Admin ei näytä sivua. Näkyvät alueet ja piilotetut välilehdet ovat käyttöliittymän mukavuustoiminto, eivät tietoturvaraja. Ne määrittävät, mitä sivupalkissa ja tietosivuilla näkyy. Ne eivät rajoita API-käyttöä — tietojen käyttöä ohjaavat kokonaan käyttöoikeudet. ## Aiheeseen liittyvää Hallitse tiimin jäseniä, määritä rooleja ja aseta käyttöoikeuksia. Miten Adminin sivupalkki on jäsennelty ja mitä kukin osio sisältää.