SharePoint Nyhetswidget
Det är möjligt att visa innehåll från SharePoint Online i GoBright View. För att kunna ställa in detta måste ett par steg tas inom SharePoint Online.
Krav och önskemål
- Ett SharePoint Online / O365 admin-konto
- Ett klient-ID
- En kundhemlighet
- Hyresgästens ID
- En eller flera SharePoint-sajter som innehåller minst en nyhetspost
Inom SharePoint
Den första delen av konfigurationen kommer att göras inom SharePoint Online.
Se till att du är inloggad med ett admin-konto så att rätt behörigheter kan ges.
Logga in på SharePoint Online
- Logga in på https://www.office.com/?auth=2 och navigera till SharePoint Online
- Se till att du är inloggad med ditt administratörskonto
Skapa ett klient-ID och en hemlighet
För att ansluta till SharePoint Online måste vi registrera applikationen.
- Gå till följande webbadress med hjälp av din SharePoint-domän:
https://[NAME].sharepoint.com/_layouts/15/AppRegNew.aspx
Till exempel: https:gobright - Generera klient-ID och hemlighet med hjälp av 'Generera' knapp
- Fyll i övriga uppgifter:
- Titel: GoBright Utsikt
- Domän för appen: wgobrightight.com
- Omdirigera URI: https://www.gobright.com/default.aspx
- Spara klient-ID och klienthemlighet
Tilldela appbehörigheter
Behörighet måste beviljas så att appen kan hämta information från SharePoint.
- Öppna PowerShell som administratör
- Kopiera och klistra in koden nedan i en textredigerare som t.ex. Notepad
- Fyll i variablerna $adminUPN och $orgName (mellan citattecknen)
AdminUPN är administratörens e-postadress
OrgName är din SharePoint-domän, till exempel: contoso.sharepoint.com (fyll sedan i contoso som orgName) - Kopiera och klistra in koden i PowerShell-prompten
- Kör skriptet
När du ombeds installera NuGet-providern följer du stegen på skärmen för att installera NuGet-providern.
När du ombeds installera eller uppdatera PowerShell-modulen följer du stegen på skärmen.
# Installera PowerShell-modulen (detta kan hoppas över om denna modul redan är installerad)
Install-Module -Name Microsoft.Online.SharePoint.PowerShell
# Fyll i organisationsnamnet nedan mellan citattecknen
$orgName= ""
# Kör sedan detta kommando för att ansluta till SharePoint, logga in som SharePoint administratör
Connect-Url https://$orgName-admin.sharepoint.com
# Kör sedan detta kommando för att sätta rätt behörighet
set-spotenant -DisableCustomAppAuthentication $false
Ange tillstånd för den specifika webbplatsen
Vi måste tillåta GoBright View att komma åt en eller flera webbplatser. Observera att denna process måste upprepas för varje webbplats som behöver visas.
- Gå till följande URL och använd din SharePoint-domän inom [DOMAIN]-parenteserna:
https://[DOMAIN].sharepoint.com/_layouts/15/appinv.aspx
Till exempel: https://gobright.sharepoint.com/_layouts/15/appinv.aspx -
Använd följande länk för att ange behörigheter för en viss SITE :
https://[DOMAIN].sharepoint.com/sites/[SITE]/_layouts/15/appinv.aspx
Exempel: https:gobright - Fyll i uppgifterna Klient-ID som just har genererats inom ramen för App-ID-fält
- Tryck på Search och den skapade registreringen bör vara synlig
- Nästa under Begäran om tillstånd XML kopiera följande del:
<AppPermissionRequests AllowAppOnlyPolicy="true">
<AppPermissionRequest Scope="http://sharepoint/content/sitecollection" Right="FullControl" />
</AppPermissionRequests> - Appen har nu rätt behörigheter. Tryck på Skapa knappen för att fortsätta:
- Tryck på Trust it-knappen för att avsluta konfigurationen av behörigheterna
- Upprepa dessa steg för varje SITE.
Till exempel: gobright //gobright.sharepoint.com/sites/news gobright
Hämta hyresgästens ID
Tenant-ID:t finns i Azure-portalen.
- Gå till https://portal.azure.com/ och logga in
- I menyn till vänster klickar du på Azure Active Directory
Översiktssidan öppnas - Under Grundläggande information visas Tanant-ID och kan kopieras
Det är all information vi behöver från SharePoint, låt oss nu gå över till GoBright View.
Inom GoBright View
Lägg till widgeten i en mall eller en bild och fyll i all information som vi har samlat in ovan i widgetparametrarna.
Obs: domänen bör endast innehålla domänen före'.sharepoint.com'. Till exempel, om din SharePoint-domän är "mycompany.sharepoint.com/site/example", måste endast "mycompany" fyllas i parametern.
Om Site Name lämnas tomt visas information från SharePoint-huvudsidan.
Efter att denna information har lagts till bör du se informationen från SharePoint.
Observera att endast en enda SharePoint Teams-webbplats kan anges per widget. Om du vill visa flera webbplatser kan du lägga till en annan widget med en annan webbplats.
Om meddelandet "Something went wrong with retrieving the token" visas är det något fel med inloggningsuppgifterna eller klient-ID:t. Kontrollera att parametrarna är korrekt inställda.
Vad gör du om widgeten plötsligt slutar fungera?
Om SharePoint-widgeten plötsligt slutade fungera och/eller detta fel dyker upp:
Det är mycket troligt att Client Secret-token har löpt ut. Detta händer varje år på grund av Microsofts policy. Vi rekommenderar att du lägger in en påminnelse i din kalender för att skapa ett nytt Client ID / Client Secret en månad innan, för att förhindra driftstopp.
Så här får du ett nytt klient-ID och en ny hemlighet
Eftersom det inte är möjligt att förnya en befintlig klient måste du skapa en ny och sedan använda dessa referenser i GoBright View. Du behöver bara uppdatera inloggningsuppgifterna i de befintliga bilderna som innehåller SharePoint-widgeten.
Detta kan göras genom att utföra stegen ovan.
Hur information visas i widgeten
Nyheter, inlägg eller sidor från SharePoint kommer att visas i View Widget enligt nedan.
Det finns olika parametrar för textstorlek, färger och visningsalternativ.
Platshållarbilder kommer att visas i portalen. På enheterna är de faktiska bilderna synliga.
Lägg till nyhetsartiklar eller webbplatssidor inom SharePoint
På grund av en begränsning i SharePoint API kommer alla nyheter att vara synliga i GoBright View, detta inkluderar nyheter som är ett koncept/utkast/ej publicerade. Vi rekommenderar att du använder schemaläggning inom SharePoint och/eller använder ett filternyckelord för att ha full kontroll över vilka nyheter som visas i GoBright View. Mer information om detta finns längst ner i denna artikel.
Det måste finnas minst en nyhetsartikel eller sida på webbplatsen. Annars finns det inget att visa i widgeten.
För att lägga till ett nyhetsobjekt eller en webbplats sida, gå över till SharePoint och klicka på + Ny. Välj sedan News Post. Följ guiden för att lägga till ett inlägg.
Titeln, sidbeskrivningen och miniatyrbilden kommer att visas i GoBright View Widget.
För att redigera dessa fält, öppna panelen Siddetaljer. Klicka på Update News om du är klar.
SharePoint Widget i GoBright View uppdateras automatiskt när ett inlägg i SharePoint läggs till eller uppdateras. Det finns inget behov av att uppdatera widgeten i GoBright View.
Det är också möjligt att använda ett anpassat fält som utdrag. Vänligen läs valfria inställningar.
Obs: För att vara säker på att bilderna i GoBright View är synliga , ladda upp dem till SharePoint. När du använder bildsökningen från SharePoint kan resultaten komma från tredjepartskällor. Detta kan orsaka att bilderna inte visas korrekt i GoBright View.
Obs: SharePoint kommer att använda den första texten på sidan som beskrivning, längre texter kommer att avkortas med ellips. Det är möjligt och rekommenderas att redigera beskrivningen efter dina behov.
Valfria inställningar
Schemalagda nyhetsinlägg
Inom SharePoint kan nyhetsartiklar schemaläggas för att gå live vid ett visst datum / tid. Schemaläggning är ett valfritt alternativ som kan aktiveras per SharePoint-webbplats.
Mer information om schemaläggning av nyhetsinlägg finns i den här Microsoft-artikeln.
GoBright View SharePoint News widget känner igen schemalagda nyhetsartiklar automatiskt och visar endast dessa artiklar från det schemalagda datumet / tiden och framåt.
Visa bara vissa nyhetsinlägg med hjälp av ett filtrerat nyckelord
Widgetparametern Filter on this keyword kan användas i kombination med en anpassad SharePoint-egenskap för att endast visa objekt där denna egenskap är inställd. Till exempel: en anpassad ja/nej-egenskap som heter ShowOnSignage.
På så sätt har du fullständig kontroll över vilka nyhetsinlägg som är synliga i GoBright View.
För att ställa in detta, gå till SharePoint och öppna webbplatsen som innehåller de nyhetsinlägg som du vill visa i GoBright View och sedan:
- Klicka på Sidor
- Klicka på Lägg till kolumn
- Klicka på Ja/Nej
Fyll i uppgifterna och se till att det inte finns några mellanslag i namnet. Vi behöver det namnet senare i GoBright View.
Klicka på Spara.
För att ställa in denna egenskap till Yes:
- Klicka på de tre prickarna
- Klicka mer
- Klicka på Egenskaper
Ställ in egenskapen på Yes.
Använd en anpassad egenskap som utdrag
Det kan vara användbart att visa ett utdrag av ett nyhetsinlägg på den digitala skylten. Standardfältet för sammanfattning i ett SharePoint-nyhetsinlägg genereras automatiskt och trunkeras. Vi rekommenderar att du lägger till en anpassad egenskap och sedan låter GoBright SharePoint News Widget hämta sin text från den egenskapen för att ha full kontroll över den text som visas på dina skyltdisplayer.
För att ställa in detta, gå över till SharePoint och följ samma steg som beskrivs ovan för att ställa in en Yes / No-egenskap. Istället för Yes/No väljer du Multiple lines of text. Återigen behöver vi namnet inom GoBright View.
Inom GoBright View, gå till SharePoint News widgetparametrar och fyll i namnet på Hämta beskrivning från anpassad SharePoint-egenskap.
Glöm inte att fylla i utdragsfältet när du lägger till ett nyhetsinlägg i SharePoint.
Felsökning
Läs artikeln Felsökning av SharePoint för mer information.