Integrace SharePoint AE077

Obecný popis #

Toto rozšíření umožňuje nahrávat přílohy, včetně příloh došlých dokladů, na SharePoint pomocí Graph API. Nahrávací procedura přesouvá přilohy dokumentů do SharePoint pomocí plánovatelné úlohy 79093 (Process SharePoint Profiles). Úloha zároveň odstraní dokumenty, které již nejsou nikde připojeny.

SharePoint dokumenty #

Seznam dokumentů nahraných přes rozšíření. Obsahuje název, datum a čas, id uživatele, SharePoint url a SharePoint id.

SharePoint dokument lze ze seznamu otevřít, stáhnout nebo přesunout do jiného definovaného umístění. Dále je možné zobrazit všechny navázané Přílohy dokladů pomocí prokliku Odkazy. Dokumenty, které nemají žádnou svázanou přílohu je možné odstanit. Odstraněné dokumenty jsou odstraněny nejen z BC ale i ze vzdálené SharePoint složky.

Nastavení #

Závislosti #

• Graph API (AE068) - rozšíření použité pro komunikaci s graph API
• Artex Addon Core (AE051) - Základní funkcionalita pro obecné nebo interní rozšíření používané při tvorbě ostatních rozšíření

Nastavení Graph API profilu #

Graph API profil určuje kód Autentizace REST, který rozšíření využije pro přístup k SharePointu.

Nastavení Autentizace REST #

Rozšíření přistupuje k SharePoint API pomocí registrované aplikace. Registrace aplikace je popsána v dokumentaci Microsoft Entra.

• Supported account types - Accounts in this organizational directory only

• API permissions

  • Vyberte jednu z následujícíh možností:
    • Microsoft Graph / Application permissions / Sites.FullControl.All
      • Aplikace má plný přístup ke všem SharePoint site v organizaci (včetně OneDrive uživatelů).
      • Nevyžaduje žádné další nastavení.
    • Microsoft Graph / Application permissions / Sites.Selected
      • Aplikace má přístup pouze k vybraným SharePoint site.
      • Vyžaduje nastavení přístupů s rolí fullcontrol k jednotlivým site. Nastavení je možné provést pomocí API Create permission.

• Certificates & secrets

  • Založte nový secret a zkopírujte jeho hodnotu.

• Šablona Graph API.

  • Šablona předvyplní nasledující hodnoty:
    • Typ ověření OAuth 2.0
    • Rozsah https%3A%2F%2Fgraph.microsoft.com%2F.default
    • Autentizace klienta Odeslat jako hlavičku Basic Auth
    • URL pro získání přístupového tokenu https://login.microsoftonline.com/{tenant}/oauth2/v2.0/token
      • {tenant} je nutné nahradit za id nebo název tenantu, například https://login.microsoftonline.com/artex-is.cz/oauth2/v2.0/token

• ID klienta - Application (client) ID z registrované aplikace

• Tajný klíč klienta - Secret value z registrované aplikace

Správné nastavení lze ověřit kliknutím na Získat nový token.

SharePoint umístění #

Tabulka pro lokální mapování SharePoint sites/drives/složek. Zakládání je řízeno přes asistované nastavení, spuštěno přes akci Nová složka v seznamu umístění.

Nastavení nového SharePoint umístění #

1. stránka je jenom přivítací, pokračujeme stisknutím tlačítka Další

2. stránka obsahuje výběr pro Profil Graph API, ze kterého chceme čerpat obsah SharePointu

3. stránka slouží na výběr konkrétních složek profilu. Název Site, Název Drive a Cesta složky je možné zadat výběrem ze seznamu kliknutím na tři tečky vedle pole. Pokud při vyvolaní akce Nová složka byla označena Site nebo Drive na stránce SharePoint umísťění, tyto pole jsou automaticky předvyplněny.

   Přepnutím přepínače Zadat ručně se zobrazí sekundární pohled stránky. Uživatel musí ručně zadat konkrétní hodnoty Site Id, Drive Id a Cesta složky, nebo jsou předvyplněny výběrem z primárního pohledu. Název Site a Název Drive nemusí koresponodovat se žádnými existujícími pojmenováními v SharePointu, je to jenom označení, pod kterým bude Site/Drive vidět na SharePoint umístění.

   

   Tento pohled je pro uživatele, kteří nemají přístup ke všem Site. Nebo když mají hodnoty Id po ruce a chtějí si ušetřit čas.

4. stránka slouží pro potvrzení nového umístění. Kliknutím na Dokončit se vybrané složky uloží pod vhodné existující Site a Drive, nebo se vytvoří nové.

SharePoint profily #

Nastavení tabulek, jejichž přílohy budou odesílány na SharePoint. Nutné nastavení je číslo tabulky a číslo SharePoint umístění, kam budou dokumenty nahrávány. Dále lze specifikovat filtr přes pole Pohled tabulky. V případě založení více profilů pro stejnou tabulku je jejich pořadí řízeno dle pole Pořadí.

Složky SharePoint profilu #

U profilu lze nastavit dynamicky generované podsložky. Nutné nastavení je Číslo pole, jehož hodnota bude použita pro název složky, a pole Pokud prázdné, které bude použito pokud je hodnota vybraného pole prázdná. Dále je možné definovat formátovací řetězec funkce Format(), který je použit při formátování názvu.