Takaisin oppaisiin
Integraatiot

SharePoint-integraation määritys

~15 min | Päivitetty viimeksi 27. elokuuta 2026

Yleiskuva

Findable yhdistyy Microsoft SharePointiin Microsoft Graph API:n kautta. Kun yhteys on valmis, Findable voi seurata valittuja SharePoint-sivustoja, driveja tai kansioita ja peilata dokumentit Findableen luokittelua, hakua ja rakennettä varten.

Taustalla tapahtuu tämä:

  • Findable tallentaa organisaatiolle yhden salatun Microsoft-tunnistejoukon.
  • Findable luo subscriptionin jokaiselle SharePoint-sivustolle ja drivelle, joka kytketään rakennukseen.
  • Kun tiedostoja lisätään tai muutetaan SharePointissa, Findable saa siitä automaattisen ilmoituksen.
  • Dokumentit tuodaan Findableen, luokitellaan, tagitetaan ja tehdään haettäviksi.
  • Jos vienti on päällä, Findable voi kirjoittaa käsiteltyjä dokumentteja ja metatietoja takaisin SharePointiin.

Findable noudattaa Microsoftin API-rajoja ja käsittelee muutokset tenant-kohtaisesti.

Tietoturva ja oikeudet

Findable tunnistautuu Microsoft Graph API:in Microsoft Entra ID:n App Registrationilla, aiemmin Azure AD. IT-tiiminne päättää tarkasti, mihin Findablella on pääsy.

Kaksi käyttöoikeustapaa

TilaOikeusMitä se tekee
Täysi pääsySites.Read.AllAntaa lukuoikeuden kaikkiin SharePoint-sivustoihin tenantissa. Käytä Sites.ReadWrite.All, jos Findablen pitää myös kirjoittaa tiedostoja tai metatietoja takaisin SharePointiin.
Rajattu pääsySites.SelectedAntaa pääsyn vain niihin SharePoint-sivustoihin, jotka hyväksytään erikseen. Sopii organisaatioille, jotka haluavat ohjata pääsyä sivustokohtaisesti.

Tunnistautuminen käyttää apprekisteroinnin client secretia. Secret salataan Findablessa ja sitä käytetään vain lyhytkestoisten access tokenien hakemiseen Microsoftilta.

Määritys

Tarvitset organisaation Microsoft Entra ID -ylläpitäjän. Työhön menee yleensä noin 15 minuuttia.

Vaihe 1: Luo apprekisterointi

  1. Kirjaudu Microsoft Entra admin centeriin ja siirry kohtaan App registrations -> New registration.

    Luo uusi apprekisterointi Microsoft Entrassa

  2. Anna sovellukselle selkeä nimi, esimerkiksi Findable SharePoint Integration, ja jätä muut kentät oletuksiin. Klikkaa Register.

    Ota talteen Application (client) ID. Sitä tarvitaan myöhemmin.

    Apprekisterointilomake, jossa Application ID on korostettu

  3. Avaa vasemmasta valikosta Certificates & secrets ja klikkaa New client secret.

    Certificates and secrets Entrassa

  4. Lisää kuvaus, esimerkiksi Findable integration, valitse voimassaoloaika ja klikkaa Add.

    Uuden client secretin luonti

  5. Kopioi client secretin Value heti. Arvo näytetään vain kerran. Ota talteen myös Secret ID.

    Client secret value ja Secret ID

Vaihe 2: Anna API-oikeudet

  1. Avaa vasemmasta valikosta API permissions ja klikkaa Add a permission.

    API permissions

  2. Valitse Microsoft Graph.

    Microsoft Graphin valinta

  3. Valitse Application permissions, ei delegated permissions.

    Application permissionsin valinta

  4. Valitse pääsytaso:

    • Vaihtoehto A, täysi pääsy: Etsi ja valitse Sites.Read.All, tai Sites.ReadWrite.All, jos Findablen pitää kirjoittaa takaisin SharePointiin. Siirry sitten vaiheeseen 3.
    • Vaihtoehto B, rajattu pääsy: Etsi ja valitse Sites.Selected. Jatka kohdasta 5.

    Sites-oikeuksien valinta

  5. Vain Sites.Selected: Avaa Microsoft Graph Explorer ja kirjaudu ylläpitäjän tunnuksella.

    Graph Explorer -kirjautuminen

  6. Vain Sites.Selected: Etsi sen SharePoint-sivuston ID, johon Findable saa päästä. Lähetä GET request:

    https://graph.microsoft.com/v1.0/sites/{tenant-name}.sharepoint.com:/sites/{site-name}

    Korvaa {tenant-name} SharePoint-tenantin nimellä ja {site-name} sivuston nimellä ilman välilyöntejä. Kopioi vastauksen id.

    Site ID:n etsiminen Graph Explorerissa

  7. Vain Sites.Selected: Anna Findablelle pääsy sivustoon lähettämällä POST request:

    https://graph.microsoft.com/v1.0/sites/{site-id}/permissions

    Käytä tätä request bodya:

    {
  "roles": ["read"],
  "grantedToIdentities": [
    {
      "application": {
        "id": "{application-id}",
        "displayName": "{application-name}"
      }
    }
  ]
}

    Korvaa {site-id}, {application-id} ja {application-name} omilla arvoillanne. Käytä "write" sanan "read" sijaan, jos Findable tarvitsee kirjoitusoikeuden.

    POST request pääsyn antamiseen

  8. Toista kohdat 6 ja 7 jokaiselle SharePoint-sivustolle, johon Findable tarvitsee pääsyn.

Vaihe 3: Lisää Microsoft-arvot Findableen

  1. Kirjaudu app.findable.ai tilillä, jolla on ylläpito-oikeudet Findable-organisaatiossa.

  2. Avaa jokin portfolion rakennus.

    Rakennukseen siirtyminen Findablessa

  3. Avaa rakennuksen asetukset tai muokkausnäkymä ja valitse Integrations.

    Rakennuksen asetukset ja integraatiot

    SharePoint-integraation valinta

  4. Laajenna SharePoint, avaa Credentials ja syötä:

    • Tenant ID: Microsoft 365 tenant ID
    • Client ID: Application (client) ID vaiheesta 1
    • Client Secret: vaiheessa 1 kopioitu arvo

    Klikkaa Save.

    SharePoint-arvojen syöttö Findableen

  5. Klikkaa Test ja varmista yhteys.

  6. Valinnainen: Jos dokumentit viedään oletuksena takaisin samaan SharePoint-driveen, määritä Default Export Drive samassa Credentials-osiossa. Kohde voidaan myöhemmin vaihtaa rakennuskohtaisesti.

Yhteysarvot tallennetaan koko organisaatiolle. Ne tarvitsee syöttää vain kerran.

Vaihe 4: Luo SharePoint-subscription

Subscriptions kertovat Findablelle, mikä SharePoint-lähde syöttää tiettyä rakennusta.

  1. Pysy rakennuksen Integrations-välilehdellä ja pidä SharePoint-kortti auki.
  2. Klikkaa Create First Subscription tai Add Subscription.
  3. Valitse SharePoint-sivusto. Jos apprekisterointi käyttää Sites.Selected-oikeutta eikä sivusto listaudu automaattisesti, valitse manuaalinen URL ja liitä SharePoint-sivuston URL.
  4. Valitse drive tai dokumenttikirjasto.
  5. Valitse sync scope:
    • Entire drive: tuo kaikki tuetut dokumentit valitusta drivesta.
    • Selected folders: tuo vain valitut kansiot ja niiden alikansiot.
  6. Tarkista valinnat ja klikkaa Create Subscription.

Findable käynnistää ensimmäisen synkronoinnin automaattisesti. Kansiorajatut subscriptions käynnistävät uuden synkronoinnin, jotta aiemmin ohitetut tiedostot voidaan käsitellä.

Vaihe 5: Määritä SharePoint-vienti

Käytä tätä vain, kun dokumentteja tai metatietoja kirjoitetaan takaisin SharePointiin.

  1. Avaa Export SharePoint-kortissa.
  2. Kytke Enable export päälle.
  3. Valitse vientikohde:
    • Käytä organisaation Default Export Drivea, jos sellainen on määritetty.
    • Tai klikkaa Set up export destination / Override for this building ja valitse rakennukselle sivusto, drive ja kansio.
  4. Klikkaa Export to SharePoint uusien dokumenttien vientiä varten.
  5. Käytä Re-export All, kun jo vietyjen dokumenttien metatiedot pitää päivittää.

Vientitila näyttää, kuinka monta rakennusdokumenttia SharePointissa on, ja päivittyy viennin aikana.

Tarvitsetko apua?

Jos määritys pysähtyy, ota yhteys osoitteeseen support@findable.ai tai käytä Findablen oikean alakulman chatia.
Varaa demo