Pagina SharePoint-instellingen (Mysolution)

Bij de appregistratie in de Azure portal kan gekozen worden voor Delegated permissions of Application permissions. Zie ook Documentenopslag binnen Mysolution (pdf).

Application permissions

Is gekozen voor Application permissions, schakel dan deze optie in. Alle rechten worden geregeld in Azure. De gebruiker hoeft zelf niet meer te autoriseren.

Delegated permissions

Is gekozen voor Delegated permissions, schakel deze optie dan niet in, maar stel wel de velden in de sneltab OAuth specifieke instellingen in. Zie Sneltab OAuth specifieke instellingen.

Het is mogelijk om de SharePoint credentials over verschillende bedrijven heen te centraliseren. Schakel daartoe dit veld in en leg de credentials centraal vast op de pagina SharePoint-instellingen (Mysolution). Zie ook Pagina SharePoint gedeelde credentials.

Is de optie Gebruik gedeelde credentials niet ingeschakeld, dan geeft u in dit veld de id op van de Azure Active Directory-toepassing die wordt gebruikt om verbinding te maken met de SharePoint-omgeving.

Is de optie Gebruik gedeelde credentials ingeschakeld, dan is dit veld niet wijzigbaar. In dat geval stelt u de client-id in op de pagina SharePoint gedeelde credentials. Zie ook Pagina SharePoint gedeelde credentials.

Is de optie Gebruik gedeelde credentials niet ingeschakeld, dan geeft u in dit veld het geheim op van de Azure Active Directory-toepassing die wordt gebruikt om verbinding te maken met de SharePoint-omgeving.

Is de optie Gebruik gedeelde credentials ingeschakeld, dan is dit veld niet wijzigbaar. In dat geval stelt u de client-secret in op de pagina SharePoint gedeelde credentials. Zie ook Pagina SharePoint gedeelde credentials.

Is de optie Gebruik gedeelde credentials niet ingeschakeld, dan stelt u in dit veld de tenant ID in Azure Active Directory in.

Is de optie Gebruik gedeelde credentials ingeschakeld, dan is dit veld niet wijzigbaar. In dat geval stelt u de AAD Tentant ID in op de pagina SharePoint gedeelde credentials. Zie ook Pagina SharePoint gedeelde credentials.

Geef de URL op waarin uw documenten worden opgeslagen, de SharePoint Online site.

Als u gebruik wilt maken van SharePoint, moet dit veld gevuld zijn.

De URL zal iets zijn als https://<Company.SharePoint.com/sites/<Sitename>

De URL kan ook al mappen bevatten als dat onderdeel is van de URL van de bibliotheek. Voorbeelden hiervan zijn “https://bedrijf.sharepoint.com/sites/MySolution/” en “https://bedrijf.sharepoint.com/sites/MS-Documents/”.

Een manier om te achterhalen wat deze URL zou moeten zijn is:

1. Ga naar de SharePoint omgeving.
2. Ga naar Mijn Sites.
   
   
3. Klik op de juiste site.
4. Kopieer nu de URL.

De naam van de SharePoint Online Documentenbibliotheek. Meestal is dat Documents of Documenten.

Dit veld kan relevant zijn als met meerdere centrale bedrijven wordt gewerkt die de documenten separaat willen kunnen opslaan, met alternatieve permissies.

Als dit veld leeg blijft, wordt in de root van de SharePoint site een soortgelijke mappenstructuur aangemaakt als bij een filesystem (Documents, Interactions en Readonly), zie Veld Documentmap.

Als dit veld wordt gevuld, wordt eerst een map aangemaakt met de in dit veld ingevulde naam. Daaronder wordt ook de mappenstructuur aangemaakt.

Het kan ook nog zijn dat alle documenten inclusief bedrijfsmappen in een submap zijn gezet op SharePoint. Een voorbeeld: de bestanden zijn in een map Documenten gezet. Dan stelt u in dit veld deze mapnaam in, dus Documenten gevolgd door de bedrijfsnaam: Documenten\Bedrijfsnaam.

Geef aan hoe Office-bestanden die op SharePoint zijn opgeslagen standaard geopend moeten worden, in bewerkmodus of in alleen-lezen modus. Eenmaal geopend kan een gebruiker deze modus zelf wisselen.

Online

Bij documentopslag op SharePoint worden Office-bestanden standaard geopend in de browser (SharePoint Online). Als een gebruiker het bestand in de desktop-app wil openen, dan moet hij/zij na het openen in de browser kiezen voor Openen in desktop-app.

Desktop-app

Het is mogelijk om Office-bestanden standaard te openen in de desktop-app. Stel dan de waarde Desktop App in.

Bestanden met de volgende bestandsextensies zijn direct te openen:

• xlsx
• xls
• docx
• doc
• pptx
• ppt

Andere bestanden worden gedownload en geopend in de bijbehorende applicatie, afhankelijk van de daarvoor geconfigureerde software op de computer (pdf-bestanden bijvoorbeeld automatisch openen in de browser).

Bij wijzigbare documenten wordt een vergrendeling gezet zodat maar 1 gebruiker het document kan bewerken. Deze vergrendeling wordt niet altijd opgeheven door SharePoint bij het sluiten van een document of als gewisseld wordt van 'Bewerken'- naar 'Weergeven'-modus. Dit levert een probleem op als het document ter ondertekening aangeboden moet worden, omdat het dan nog lijkt dat het bestand vergrendeld is door andere gebruiker. In dat geval treedt foutmelding '423 file is locked' op.

Om deze fouten te verminderen kunt u deze optie inschakelen. Inschakelen van deze optie zorgt ervoor dat het verwijderen van bestanden op SharePoint via Graph niet meer direct wordt afgehandeld, maar asynchroon door een taakwachtrij. De verwijderactie wordt namelijk in een wachtrij geplaatst. Die wachtrij is zichtbaar op de pagina SharePoint actie wachtrij, waarin alle te verwijderen bestanden komen te staan.

Als u de optie inschakelt wordt:

• op de actiebalk de knop Bekijk actie wachtrij actief. Daarmee opent u de pagina SharePoint actie wachtrij.

Let op: Als deze optie is ingeschakeld, geldt dit voor alle verwijderacties, dus bijvoorbeeld ook als een interactie wordt verwijderd.

• op de actiebalk de knop Bekijk taakwachtrij actief. Daarmee opent u de taakwachtrijpost met codeunit 11096168. Bestaat die taakwachtrijpost nog niet, dan krijgt u de vraag om deze aan te maken.

• de sneltab SharePoint Actie taakwachtrij zichtbaar. Deze toont de status van de taakwachtrijpost en de vroegste startdatum en -tijd.

Taakwachtrijpost met codeunit 11096168

Om de bestanden in de wachtrij te verwijderen, moet een taakwachtrijpost met codeunit 11096168 (MYS SharePoint Action JQ) zijn ingesteld.

Zie ook

Pagina SharePoint actie wachtrij

Taakwachtrijposten in MSF

Als een request mislukt wordt deze bij de volgende http statuscodes opnieuw verstuurd:

• 500 Internal Server Error
• 503 Service Unavailable
• 504 Gateway Timeout
• 509 Bandwidth Limit Exceeded
• 429 Rate Limit Exceeded

In dit veld kunt u instellen hoeveel pogingen er maximaal mogen worden gedaan.

Als een request mislukt wordt deze bij de volgende http statuscodes opnieuw verstuurd:

• 500 Internal Server Error
• 503 Service Unavailable
• 504 Gateway Timeout
• 509 Bandwidth Limit Exceeded
• 429 Rate Limit Exceeded

In dit veld kunt u het aantal seconden tussen elke nieuwe poging instellen.

De interval tussen nieuwe pogingen wordt vermenigvuldigd met de huidige poging. Het veld Totale gecombineerde time-out toont de uiteindelijke duur.

Zie Veld Interval (in seconden) tussen nieuwe pogingen.

Het is mogelijk om de gebruiker via Just-In-Time machtigingen te autoriseren. Voorwaarde hierbij is dat gebruikgemaakt wordt van App Registration modus (in plaats van Delegated Permissions).

Het doel hierbij is dat een gebruiker geen rechten meer nodig heeft op SharePoint, maar dat deze rechten alleen aan een admin en een appregistratie zijn toegewezen. Bij het openen van een document vanuit Business Central worden Just-In-Time rechten verleend tot het specifieke document. Deze rechten worden weer ingetrokken na de ingestelde tijd (in het veld Levensduur JIT-machtingen (in uren)).

Zie ook SharePoint Just-In-Time (JIT) permissions (pdf) voor alle voorwaarden.

Dit veld is alleen actief als Gebruik JIT-machtigingen is ingeschakeld.

Geeft aan of een taakwachtrijpost met codeunit 11096168 staat ingesteld die de JIT-machtigingen intrekt na de levensduur (die is ingesteld in het veld Levensduur JIT-machtingen (in uren)).

Als u de optie inschakelt wordt:

• op de actiebalk de knop Bekijk actie wachtrij actief. Daarmee opent u de pagina SharePoint actie wachtrij.

• op de actiebalk de knop Bekijk taakwachtrij actief. Daarmee opent u de taakwachtrijpost met codeunit 11096168. Bestaat die taakwachtrijpost nog niet, dan krijgt u de vraag om deze aan te maken.

• de sneltab SharePoint Actie taakwachtrij zichtbaar. Deze toont de status van de taakwachtrijpost en de vroegste startdatum en -tijd.

Dit veld is alleen wijzigbaar als als Gebruik JIT-machtigingen is ingeschakeld.

Bij het openen van een document vanuit Business Central worden Just-In-Time rechten verleend tot het specifieke document. Deze rechten worden weer ingetrokken na de tijd die in dit veld is ingesteld. Standaard is 12 uur ingesteld.

Dit veld is alleen wijzigbaar als als Gebruik JIT-machtigingen is ingeschakeld.

Stel in of alleen-lezen bestanden worden gedownload of geopend kunnen worden in de browser.

Als dit veld [vanaf release 24.01.1000] is ingeschakeld en de SharePoint-virusscanner heeft een bepaald document als potentieel besmet aangemerkt, dan kan dat document niet meer gedownload worden. In plaats daarvan krijgt de gebruiker een blokkerende foutmelding:

"Het document is door SharePoint gemarkeerd als malware en kan niet worden geopend."

Vanuit veiligheidsoverwegingen is dit veld standaard ingeschakeld, maar het kan indien gewenst worden uitgeschakeld.

Een gebruiker die rechten heeft om zo'n (wijzigbaar) bestand op SharePoint te openen, krijgt een melding van SharePoint:

"If you want to open this file, you'll need to clean the file using your own scanning software. Do you want to save the file to your computer and attempt to clean it? "

In dit veld geeft u de omleidings-URL op van de Azure Active Directory-toepassing die wordt gebruikt om verbinding te maken met de SharePoint-omgeving.

Als u dit veld leeg laat, wordt de standaardomleidings-URL gebruikt. Klik op Om te zien welke URL dit is.

Als de omleidings-URL niet klopt zal de consent flow bij de knop Verbinding testen niet goed gaan. Let ook op dat bij de App registratie in Azure dezelfde URL benoemd staat onder ‘Authentication’ -> ‘Web Redirect URIs'.

Geeft het type gebruikersinteractie aan bij het verkrijgen van een access token:

• Geen promptparameter in de aanvraag - Zorgt ervoor dat de gebruiker geen interactieve prompt te zien krijgt. Als de aanvraag niet op de achtergrond kan worden voltooid via eenmalige aanmelding, retourneert de Microsoft identity platform een fout.
• Aanmelden - Dwingt de gebruiker om zijn/haar referenties op die aanvraag in te voeren, waardoor eenmalige aanmelding wordt genegeerd.
• Account selecteren - Stuurt de gebruiker naar een accountkiezer waar alle accounts die in de sessie worden onthouden, worden weergegeven.
• Toestemming - Activeert het dialoogvenster OAuth-toestemming nadat de gebruiker zich heeft aangemeld en vraagt de gebruiker machtigingen te verlenen aan de app.

Als deze optie is geactiveerd, dan kan een gebruiker of web-API een document downloaden uit de SharePoint folder namens de gebruiker die in het veld Gebruikersnaam staat. In het geval van webclientgebruikers geldt het bij bestanden die in de ReadOnly map staan in SharePoint en voor alle documenten die benaderd worden via de web-API of andere processen waar geen webclient aan te pas komt.

Op het moment dat gebruik gemaakt wordt van autorisatie op de Readonly map in SharePoint, dan moet een On-Behalf-Of account ingesteld worden. Dit kan op de volgende manier:

1. Stel het veld Prompt Interaction naar wens in (vergeet niet deze naderhand terug te zetten).
2. Schakel de optie Activeer On-Behalf-Of in.
3. Vul de juiste gebruikersnaam in.
4. Klik op de actiebalk op de knop Forceer On-Behalf-Of Consent om toestemming te geven volgens de ingestelde gebruiker.
5. Controleer de inloghint en klik op Ja.
6. Selecteer het juiste account.

De read-only documenten worden dan geüpload via de ingestelde gebruiker.

Schakel deze optie niet in als op de Readonly map in SharePoint geen autorisatie is ingesteld.

Dit is de gebruikersnaam van de On-Behalf-Of gebruiker. Deze kan gewijzigd worden als Activeer On-Behalf-Of is ingeschakeld.