Widget til SharePoint-nyheder
Det er muligt at vise indhold fra SharePoint Online i GoBright View. For at opsætte dette skal der tages et par skridt i SharePoint Online.
Kravene
- En SharePoint Online/O365-administratorkonto
- Et klient-id
- En klienthemmelighed
- Lejerens ID
- Et eller flere SharePoint-sider, der indeholder mindst én nyhedspost
Inden for SharePoint
Den første del af konfigurationen foretages i SharePoint Online.
Sørg for, at du er logget ind med en administratorkonto, så de korrekte tilladelser kan tildeles.
Log ind på SharePoint Online
- Log ind på https://www.office.com/?auth=2 og naviger til SharePoint Online
- Sørg for, at du er logget ind med din administratorkonto
Opret et klient-id og en hemmelighed
For at oprette forbindelse til SharePoint Online skal vi registrere applikationen.
- Gå til følgende url med dit SharePoint-domæne:
https://[NAME].sharepoint.com/_layouts/15/AppRegNew.aspx
For eksempel: https:gobright - Generer klient-id'et og -hemmeligheden ved hjælp af 'Generer' knap
- Udfyld de øvrige oplysninger:
- Titel: GoBright
- App-domæne: wgobrightight.com
- Omdiriger URI: https://www.gobright.com/default.aspx
- Gem klient-id' et og klienthemmeligheden
Giv app-tilladelser
Der skal gives tilladelse til, at appen kan hente oplysninger fra SharePoint.
- Åbn PowerShell som administrator
- Kopier og indsæt koden nedenfor i en teksteditor som Notepad
- Udfyld variablerne $adminUPN og $orgName (mellem anførselstegnene)
AdminUPN er administratorens e-mailadresse
OrgName er dit SharePoint-domæne, for eksempel: contoso.sharepoint.com (udfyld derefter contoso som orgName) - Kopier og indsæt koden i PowerShell-prompten
- Kør scriptet
Når du bliver bedt om at installere NuGet-provideren, skal du følge trinnene på skærmen for at installere NuGet-provideren.
Når du bliver bedt om at installere eller opdatere PowerShell-modulet, skal du følge trinnene på skærmen.
# Installer PowerShell-modulet (dette kan springes over, hvis modulet allerede er installeret)
Install-Module -Name Microsoft.Online.SharePoint.PowerShell
# Udfyld organisationsnavnet nedenfor mellem anførselstegnene
$orgName= ""
# Kør derefter denne kommando for at oprette forbindelse til SharePoint, log ind som SharePoint-administrator
Connect-SPOService -Url https://$orgName-admin.sharepoint.com
# Kør derefter denne kommando for at indstille den rigtige tilladelse
set-spotenant -DisableCustomAppAuthentication $false
Indstil tilladelse til det specifikke sted
Vi skal give GoBright View adgang til et eller flere websteder. Bemærk, at denne proces skal gentages for hvert websted, der skal vises.
- Gå til følgende URL ved at bruge dit SharePoint-domæne inden for [DOMAIN]-parenteserne:
https://[DOMAIN].sharepoint.com/_layouts/15/appinv.aspx
For eksempel: https://gobright.sharepoint.com/_layouts/15/appinv.aspx -
Brug følgende link for at indstille tilladelser til et specifikt SITE :
https://[DOMAIN].sharepoint.com/sites/[SITE]/_layouts/15/appinv.aspx
For eksempel: https:gobright - Udfyld den Klient-ID der netop er blevet genereret i App-ID-felt
- Tryk på Søg , og den oprettede registrering bør være synlig
- Næste under Anmodning om tilladelse XML Kopier følgende del:
<AppPermissionRequests AllowAppOnlyPolicy="true">
<AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="FullControl" />
</AppPermissionRequests> - Appen har nu de korrekte tilladelser. Tryk på knappen Opret knappen for at fortsætte:
- Tryk på knappen Trust it for at afslutte opsætningen af tilladelserne.
- Gentag disse trin for hver SITE.
For eksempel: gobright //gobright.sharepoint.com/sites/news gobright
Hent lejer-id'et
Tenant-id'et kan findes i Azure-portalen.
- Gå til https://portal.azure.com/ og log ind
- I menuen til venstre skal du klikke på Azure Active Directory
Oversigtssiden åbnes - Under Grundlæggende oplysninger vises Tanant-id'et, som kan kopieres.
Det er alle de oplysninger, vi har brug for fra SharePoint, så lad os nu gå over til GoBright View.
Inden for GoBright View
Føj widgetten til en skabelon eller et slide, og udfyld alle de oplysninger, vi har indsamlet ovenfor, i widgetparametrene.
Bemærk: Domænet skal kun indeholde domænet før '.sharepoint.com'. Hvis dit SharePoint-domæne f.eks. er 'mycompany.sharepoint.com/site/example', er det kun 'mycompany', der skal udfyldes i parameteren.
Hvis Site Name ikke er udfyldt, vises oplysninger fra SharePoints hovedside.
Når disse oplysninger er tilføjet, bør du kunne se oplysningerne fra SharePoint.
Bemærk, at der kun kan indtastes et enkelt SharePoint Teams-sted pr. widget. Hvis du vil vise flere sider, kan du tilføje en anden widget med en anden side.
Hvis meddelelsen "Something went wrong with retrieving the token" vises, er der noget galt med legitimationsoplysningerne eller lejer-id'et. Sørg for, at parametrene er indstillet korrekt.
Hvad gør man, hvis widgetten pludselig holder op med at virke?
Hvis SharePoint-widget'en pludselig holder op med at virke og/eller denne fejl dukker op:
Det er meget sandsynligt, at Client Secret-tokenet er udløbet. Det sker hvert år på grund af Microsofts politik. Vi anbefaler, at du indstiller en påmindelse i din kalender om at oprette et nyt klient-id/klienthemmelighed en måned før for at forhindre nedetid.
Sådan får du et nyt klient-id og en ny hemmelighed
Da det ikke er muligt at forny en eksisterende klient, bliver du nødt til at oprette en ny og derefter bruge disse legitimationsoplysninger i GoBright View. Du skal bare opdatere legitimationsoplysningerne i de(t) eksisterende slide(s), der indeholder SharePoint-widgetten.
Dette kan gøres ved at udføre ovenstående trin.
Hvordan information vises i widgetten
Nyheder, indlæg eller sider fra SharePoint vil blive vist i View Widget som vist nedenfor.
Der er forskellige parametre for tekststørrelse, farver og visningsmuligheder.
Der vises pladsholderbilleder i portalen. På enhederne er de faktiske billeder synlige.
Tilføj nyheder eller websider i SharePoint
På grund af en begrænsning i SharePoint API'en vil alle nyheder være synlige i GoBright View, også nyheder, der er et koncept/udkast/ikke offentliggjort. Vi anbefaler, at du bruger planlægning i SharePoint og/eller bruger et filternøgleord for at få fuld kontrol over, hvilke nyheder der vises i GoBright View. Mere information om dette i bunden af denne artikel.
Der skal være mindst én nyhed eller side på websitet. Ellers er der ikke noget at vise i widgetten.
For at tilføje et nyhedsindlæg eller en side skal du gå til SharePoint og klikke på + Ny. Vælg derefter News Post. Følg guiden for at tilføje et indlæg.
Titlen, sidebeskrivelsen og miniaturebilledet vil blive vist i GoBright View Widget.
For at redigere disse felter skal du åbne panelet Sidedetaljer. Klik på Opdater nyheder, hvis du er færdig.
SharePoint-widget'en i GoBright View opdateres automatisk, når et indlæg i SharePoint tilføjes eller opdateres. Det er ikke nødvendigt at opdatere widgetten i GoBright View.
Det er også muligt at bruge et brugerdefineret felt som uddrag. Læs venligst de valgfrie indstillinger.
Bemærk: For at være sikker på, at billederne i GoBright View er synlige, skal du uploade dem til SharePoint. Når man bruger billedsøgningen i SharePoint, kan resultaterne komme fra tredjepartskilder. Det kan medføre, at billederne ikke vises korrekt i GoBright View.
Bemærk: SharePoint vil bruge den første tekst på siden som beskrivelse, længere tekster vil blive afkortet med ellipse. Det er muligt og anbefales at redigere beskrivelsen efter dine behov.
Valgfrie indstillinger
Planlagte nyhedsindlæg
I SharePoint kan nyheder planlægges til at gå live på en bestemt dato/et bestemt tidspunkt. Planlægning er en valgfri mulighed, som kan aktiveres for hvert SharePoint-site.
Læs denne Microsoft-artikel for at få flere oplysninger om planlægning af nyhedsindlæg.
GoBright View SharePoint News widget genkender automatisk planlagte nyheder og viser kun disse nyheder fra den planlagte dato/det planlagte tidspunkt og fremefter.
Vis kun bestemte nyhedsindlæg ved hjælp af et filtersøgeord
Widgetparameteren Filter on this keyword kan bruges i kombination med en brugerdefineret SharePoint-egenskab til kun at vise elementer, hvor denne egenskab er indstillet. For eksempel: en brugerdefineret ja/nej-egenskab kaldet ShowOnSignage.
På denne måde har du fuld kontrol over, hvilke nyhedsindlæg der er synlige i GoBright View.
For at konfigurere dette skal du gå over til SharePoint og åbne det websted, der indeholder de nyhedsindlæg, du vil have vist i GoBright View, og derefter:
- Klik på Sider
- Klik på Tilføj kolonne
- Klik på Ja/Nej
Udfyld detaljerne, og sørg for, at der ikke er mellemrum i navnet. Vi får brug for det navn senere i GoBright View.
Klik på Gem.
For at sætte denne egenskab til Yes:
- Klik på de tre prikker
- Klik mere
- Klik på Egenskaber
Sæt egenskaben til Yes.
Brug en brugerdefineret egenskab som uddrag
Det kan være nyttigt at vise et uddrag af et nyhedsindlæg på den digitale skiltning. Standardopsummeringsfeltet i et SharePoint-nyhedsindlæg genereres automatisk og afkortes. Vi anbefaler at tilføje en brugerdefineret egenskab og derefter lade GoBright SharePoint News Widget få sin tekst fra den egenskab for at have fuld kontrol over den tekst, der vises på dine skilteskærme.
For at opsætte dette skal du gå over til SharePoint og følge de samme trin som beskrevet ovenfor for at opsætte en Ja/Nej-egenskab. I stedet for Ja/Nej skal du vælge Flere tekstlinjer. Igen skal vi bruge navnet i GoBright View.
I GoBright View skal du gå til SharePoint News-widgetparametrene og udfylde navnet ved Hent beskrivelse fra brugerdefineret SharePoint-egenskab.
Glem ikke at udfylde uddragsfeltet, når du tilføjer et nyhedsindlæg i SharePoint.
Fejlfinding
Læs artiklen Fejlfinding i SharePoint for at få flere oplysninger.