SharePoint News Widget
Det er mulig å vise innhold fra SharePoint Online innenfor GoBright Utsikt. For å sette opp dette må du ta et par trinn i SharePoint Online.
Krav
- En administratorkonto for SharePoint Online / O365
- En klient-ID
- En klienthemmelighet
- Leietaker-ID
- Ett eller flere SharePoint-nettsteder som inneholder minst ett nyhetsinnlegg
Innenfor SharePoint
Den første delen av konfigurasjonen vil bli gjort i SharePoint Online.
Sørg for at du er logget på med en administratorkonto slik at de riktige tillatelsene kan gis.
Logg på SharePoint Online
- Logg på https://www.office.com/?auth=2 og naviger til SharePoint Online
- Sørg for at du er logget på med administratorkontoen din
Opprett en klient-ID og en hemmelighet
For å koble til SharePoint Online må vi registrere applikasjonen.
- Gå til følgende url ved å bruke SharePoint-domenet ditt:
https://[NAME].sharepoint.com/_layouts/15/AppRegNew.aspx
For eksempel: https:// gobright .sharepoint.com/_layouts/15/AppRegNew.aspx - Generer klient-ID og hemmelighet ved å bruke 'Generere'-knappen
- Fyll inn de andre detaljene:
- Tittel: GoBright Utsikt
- App-domene: www. gobright .com
- Omdiriger URI: https://www. gobright .com/default.aspx
- Lagre klient-ID og klienthemmelighet
Gi apptillatelser
Tillatelse må gis slik at appen kan hente informasjon fra SharePoint.
- Åpne PowerShell som administrator
- Kopier og lim inn koden nedenfor i et tekstredigeringsprogram som Notisblokk
- Fyll inn variablene $adminUPN og $orgName (mellom anførselstegnene)
AdminUPN er admin-e-postadressen
orgName er SharePoint-domenet ditt, for eksempel: contoso.sharepoint.com (fyll deretter inn contoso som orgName) - Kopier og lim inn koden i PowerShell-ledeteksten
- Kjør skriptet
Når du blir bedt om å installere NuGet-leverandøren, følg trinnene på skjermen for å installere NuGet-leverandøren.
Når du blir bedt om å installere eller oppdatere PowerShell-modulen, følg trinnene på skjermen.
# Installer PowerShell-modulen (dette kan hoppes over når denne modulen allerede er installert)
Installasjonsmodul -navn Microsoft.Online.SharePoint.PowerShell
# Fyll inn organisasjonsnavnet nedenfor mellom anførselstegnene
$orgName= ""
# Kjør deretter denne kommandoen for å koble til SharePoint, logg inn som SharePoint-administrator
Connect -SPOService -Url https://$orgName-admin.sharepoint.com
# Kjør deretter denne kommandoen for å angi riktig tillatelse
set-spotenant -DisableCustomAppAuthentication $false
Angi tillatelse for det spesifikke nettstedet
Vi må tillate GoBright Vis for å få tilgang til ett eller flere nettsteder. Merk at denne prosessen må gjentas for hvert nettsted som må vises .
- Gå til følgende URL ved å bruke SharePoint-domenet ditt innenfor [DOMAIN]-parentesene:
https://[DOMAIN].sharepoint.com/_layouts/15/appinv.aspx
For eksempel: https://gobright.sharepoint.com/_layouts/15/appinv.aspx -
Bruk følgende lenke for å angi tillatelser til en spesifikk SITE :
https://[DOMENE].sharepoint.com/sites/[SITE]/_layouts/15/appinv.aspx
For eksempel: https:// gobright .sharepoint.com/sites/news/_layouts/15/appinv.aspx - Fyll ut Klient-ID som nettopp har blitt generert innenfor App ID-feltet
- Trykk Søk og den opprettede registreringen skal være synlig
- Neste under Tillatelsesforespørsel XML kopier følgende del:
<AppPermissionRequests AllowAppOnlyPolicy="true">
<AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="FullControl" />
</AppPermissionRequests> - Appen har nå de riktige tillatelsene. Trykk på Skape knappen for å fortsette:
- Trykk på Trust it -knappen for å fullføre konfigureringen av tillatelsene
- Gjenta disse trinnene for hvert NETTSTED.
For eksempel: https:// gobright .sharepoint.com/sites/news eller https:// gobright .sharepoint.com/sites/showcase
Få leietaker-ID
Leietaker-ID-en finner du i Azure-portalen.
- Gå til https://portal.azure.com/ og logg inn
- I menyen til venstre klikker du på Azure Active Directory
Oversiktssiden åpnes - Under Grunnleggende informasjon vises Tanant ID og kan kopieres
Det er all informasjonen vi trenger fra SharePoint, la oss nå gå over til GoBright Utsikt.
Innenfor GoBright Utsikt
Legg til widgeten i en mal eller et lysbilde og fyll inn all informasjonen vi har samlet ovenfor i widgetparameterne.
Merk: domenet skal bare inkludere domenet før '.sharepoint.com'. For eksempel, hvis SharePoint-domenet ditt er 'mycompany.sharepoint.com/site/example', må bare 'mycompany' fylles i parameteren.
Hvis nettstedsnavn er tomt, vil det vise informasjon fra SharePoint-hovedsiden.
Etter at denne informasjonen er lagt til, skal du se informasjonen fra SharePoint.
Merk at bare ett enkelt SharePoint Teams-område kan angis per widget. Hvis du vil vise flere nettsteder, kan du legge til en annen widget med et annet nettsted.
Hvis meldingen "Noe gikk galt med å hente token" vises, er det noe galt med legitimasjonen eller leietaker-ID. Sørg for at parameterne er riktig innstilt.
Hva skal jeg gjøre hvis widgeten plutselig slutter å fungere
Hvis SharePoint-widgeten plutselig sluttet å fungere og/eller denne feilen dukker opp:
Det er svært sannsynlig at Client Secret-tokenet har utløpt. Dette skjer hvert år på grunn av Microsofts retningslinjer. Vi anbefaler å sette inn en påminnelse i kalenderen din om å opprette en ny klient-ID / klienthemmelighet en måned før, for å forhindre nedetid.
Hvordan få en ny klient-ID og hemmelighet
Fordi det ikke er mulig å fornye en eksisterende klient, må du opprette en ny og deretter bruke denne legitimasjonen innen GoBright Utsikt. Du trenger bare å oppdatere legitimasjonen i de eksisterende lysbildene som inneholder SharePoint-widgeten.
Dette kan gjøres ved å utføre trinnene ovenfor.
Hvordan informasjon vises i widgeten
Nyheter, innlegg eller sider fra SharePoint vil bli vist i Vis-widgeten som vist nedenfor.
Det er ulike parametere for tekststørrelse, farger og visningsalternativer.
Plassholderbilder vil vises i portalen. På enhetene er de faktiske bildene synlige.
Legg til nyheter eller nettstedssider i SharePoint
På grunn av en begrensning av SharePoint API vil alle nyheter være synlige i GoBright Vis, dette inkluderer nyheter som er et konsept/utkast/ikke publisert. Vi anbefaler å bruke planlegging i SharePoint og/eller bruke et filternøkkelord for å ha full kontroll over hvilke nyheter som vises i GoBright Utsikt. Mer informasjon om dette nederst i denne artikkelen .
Minst én nyhet eller side må eksistere. Ellers er det ingenting å vise i widgeten.
For å legge til en nyhet eller side, gå over til SharePoint og klikk på + Ny. Velg deretter Nyhetsinnlegg. Følg veiviseren for å legge til et innlegg.
Tittelen, sidebeskrivelsen og miniatyrbildet vises i GoBright Vis widget.
For å redigere disse feltene, åpne Sidedetaljer-panelet. Klikk på Oppdater nyheter hvis du er ferdig.
SharePoint-widgeten innenfor GoBright Vis oppdateres automatisk når et innlegg i SharePoint legges til eller oppdateres. Det er ikke nødvendig å oppdatere widgeten innenfor GoBright Utsikt.
Det er også mulig å bruke et egendefinert felt som utdrag . Vennligst les valgfrie innstillinger .
Merk: For å være sikker på at bildene er i GoBright Visning er synlig last dem opp til SharePoint . Når du bruker bildesøk fra SharePoint, kan resultater komme fra tredjepartskilder. Dette kan føre til at bilder ikke vises riktig i GoBright Utsikt.
Merk: SharePoint vil bruke den første teksten på siden som beskrivelse, lengre tekster vil bli avkortet med ellipsis. Det er mulig og anbefalt å redigere beskrivelsen til dine behov.
Valgfrie innstillinger
Planlagte nyhetsinnlegg
Innenfor SharePoint kan nyhetssaker planlegges til å gå live på en bestemt dato/tid. Planlegging er et valgfritt alternativ som kan aktiveres per SharePoint-side.
For mer informasjon om planlegging av nyhetsinnlegg, vennligst les denne Microsoft-artikkelen .
De GoBright Vis SharePoint News-widgeten gjenkjenner planlagte nyheter automatisk og viser kun disse elementene fra den planlagte datoen/tidspunktet og utover.
Vis kun enkelte nyhetsinnlegg med et filtersøkeord
Widgetparameteren Filter på dette nøkkelordet kan brukes i kombinasjon med en egendefinert SharePoint-egenskap for kun å vise elementer der denne egenskapen er angitt. For eksempel: en egendefinert ja/nei-egenskap kalt ShowOnSignage.
På denne måten har du full kontroll over hvilke nyhetsinnlegg som er synlige innenfor GoBright Utsikt.
For å sette opp dette, gå over til SharePoint og åpne nettstedet som inneholder nyhetsinnleggene du vil vise innenfor GoBright Se og deretter:
- Klikk på Sider
- Klikk på Legg til kolonne
- Klikk på Ja/Nei
Fyll inn detaljene og sørg for at det ikke er mellomrom i navnet. Vi trenger det navnet senere GoBright Utsikt.
Klikk Lagre.
For å sette denne egenskapen til Ja :
- Klikk på de tre prikkene
- Klikk på Mer
- Klikk på Egenskaper
Sett egenskapen til Ja .
Bruk en egendefinert egenskap som utdrag
Det kan være nyttig å vise et utdrag av et nyhetsinnlegg på den digitale skiltingen. Standard sammendragsfelt for et SharePoint-nyhetsinnlegg genereres automatisk og avkortes. Vi anbefaler å legge til en tilpasset eiendom og deretter la GoBright SharePoint News Widget henter teksten fra den egenskapen for å ha full kontroll over teksten som vises på skiltskjermene dine.
For å sette opp dette, gå over til SharePoint og følg de samme trinnene beskrevet ovenfor for å sette opp en Ja/Nei-egenskap. Velg Flere tekstlinjer i stedet for Ja/Nei . Igjen, vi trenger navnet innenfor GoBright Utsikt.
Innenfor GoBright Se, gå til widgetparameterne for SharePoint News og fyll inn navnet ved Hent beskrivelse fra egendefinert SharePoint-egenskap .
Ikke glem å fylle ut utdragsfeltet når du legger til et nyhetsinnlegg i SharePoint.
Feilsøking
Les artikkelen om feilsøking i SharePoint for mer informasjon.
