Tools voor zichtbaarheid
Controleer en wijzig de zichtbaarheid van een project.
Op deze pagina
Bekijk of wijzig wie je website mag zien. Privéwebsites vereisen inloggen bij TEISENDA.
Informatie
De verbinding geldt voor de Space. Je bent daar lid en de Space is niet geblokkeerd. Een Space is een gedeelde werkruimte in de app.
hosting_get_visibility kun je met elke rol aanroepen, ook met Alleen-lezen. Voor hosting_set_visibility heb je de rol Eigenaar, Beheerder of Gebruiker nodig.
hosting_get_visibility Get visibility
alleen lezen
Toont de zichtbaarheid en doelgroep. Bij geselecteerde personen of teams noemt de tool alleen het aantal, geen namen.
| Parameter | Type | Vereiste | Beschrijving |
|---|---|---|---|
space | Geheel getal | verplicht | De tiencijferige Space-ID. |
project | Geheel getal | verplicht | Het projectnummer zoals getoond door hosting_list_projects. |
hosting_set_visibility Set visibility
wijzigt gegevensverwijdert, overschrijft of wijzigt zichtbare inhoudtwee stappen
Maakt een project openbaar of privé. Een privéwebsite vereist inloggen bij TEISENDA; audience bepaalt wie de website daarna mag zien.
Let op
Bij de overstap van privé naar openbaar vereist de tool twee aanroepen: de eerste zonder confirm noemt de bevestigingszin, de tweede met die zin maakt de website openbaar.
De toepassing mag de zin pas na je toestemming verzenden; zie Drie tools vereisen een bevestigingszin. Een project privé maken of wijzigen wie een privéproject mag zien, vereist maar één aanroep.
audience kent drie niveaus. Elk geldt alleen voor personen die op dit moment lid zijn van de Space.
owner: alleen het account dat het project heeft aangemaakt, ziet de website. Dit heeft niets te maken met de Space-rol Eigenaar en geen enkele tool wijzigt welk account dit is. Als dat account de Space heeft verlaten, kan niemand de website openen totdat een ander niveau is ingesteld.selected: de in TEISENDA geselecteerde personen en teams zien de website, en altijd ook het account dat het project heeft aangemaakt. Geen enkele tool selecteert deze; dat doe je in TEISENDA, zie Zichtbaarheid van een website instellen.space: elk lid van de Space ziet de website.
| Parameter | Type | Vereiste | Beschrijving |
|---|---|---|---|
space | Geheel getal | verplicht | De tiencijferige Space-ID. |
project | Geheel getal | verplicht | Het projectnummer zoals getoond door hosting_list_projects. |
visibility | Tekst, een van public, private | verplicht | public maakt het project openbaar, private maakt het privé. |
audience | Tekst, een van owner, selected, space | optioneel | Wie een privéwebsite mag zien: owner, selected of space. Als de waarde bij private ontbreekt, blijft de huidige instelling van het project behouden; een nieuw project heeft owner. Bij public heeft de waarde geen effect: als de aanroep toch een waarde bevat, slaat TEISENDA deze op en geldt deze weer zodra het project privé wordt. |
confirm | Tekst | optioneel | Bij de eerste aanroep moet de toepassing dit weglaten; het antwoord noemt dan een bevestigingszin. De toepassing mag precies die zin pas verzenden nadat je toestemming hebt gegeven. Dit is alleen nodig als de aanroep een project openbaar maakt dat nog niet openbaar is. |
Als iets niet lukt
Als een oplossing een tool noemt, vraag je de toepassing deze aan te roepen.
Het argument … ontbreekt of heeft niet de verwachte vorm.
Bij hosting_set_visibility is visibility iets anders dan public of private, of audience is iets anders dan owner, selected of space; de melding noemt het argument. Roep de tool opnieuw aan met public of private en voor private met een van owner, selected of space.
Meldingen over de Space en het projectnummer staan bij de tools voor Spaces en projecten. Alle andere die bij elke tool kunnen voorkomen, staan onder Problemen met de Connector oplossen.