M-Files Ground Linkin määrittäminen

Ennen kuin otat käyttöön Ground Link -ominaisuuden, varmista että nämä edellytykset täyttyvät:

gRPC-yhteydet sallitaan paikallisella palvelimella, jonne Ground Link -välittäjä määritetään. Tätä palvelinta kutsutaan tässä ohjeessa jatkossa Ground Link -välittäjäpalvelimeksi.

Jos yhdistät Ground Link -välittäjän paikalliseen varastoon, varmista että myös nämä edellytykset täyttyvät:

gRPC-yhteydet sallitaan M-Files-palvelimella
M-Files-palvelimella on voimassa oleva TLS-varmenne gRPC-yhteyksien salaukseen.

Katso lisätietoja knowledge base -dokumentista Setting Up M-Files to Use gRPC.

Ground Link -ominaisuus otetaan käyttöön asentamalla ensin Ground Link -välittäjään ulkoisen tietovaraston konnektorit. Seuraavaksi tietovarastoyhteydet asetetaan varastossa. Tämän jälkeen voit katsoa ja muokata paikallisia tietoja suoraan varastosta.

Ground Link -yhteyden käyttöön ottaminen

Tee nämä vaiheet ottaaksesi Ground Link -kanavayhteys käyttöön varastossa:

Avaa M-Files Admin ja siirry varastoon.
1. Avaa M-Files Admin.
2. Laajenna vasemman reunan puunäkymässä M-Files-palvelinyhteys.
3. Laajenna Dokumenttivarastot.
4. Laajenna varasto.
Valitse Määritykset.
Laajenna navigointialueella Advanced Vault Settings > Configuration.
Napsauta Ground Link.
Aseta Configuration-välilehdellä Enabled-kohdan arvoksi Yes.
Napsauta Save.
Käynnistä varasto uudelleen, jotta muutokset tulevat voimaan.

Huomaa: Varasto tulee aina ottaa pois käytöstä hallitusti ja varaston käyttäjiä on tiedotettava asiasta etukäteen.
Laajenna harmaalla navigointialueella External Repositories > Ground Link ja valitse Configuration.

Määritä Configuration-välilehdellä nämä asetukset:


Asetuksen nimi		Kuvaus	Esimerkkiarvo
Enabled		Tämä asetus määrittää, onko Ground Link käytössä vai ei.	Yes
Remoting Service	Shared Secrets	Ground Link -välittäjä todentaa varaston jaetulla salaisuudella. Varmista, että jaettu salaisuus on riittävän monimutkainen ja pitkä. Voit määrittää yhden tai useamman jaetun salaisuuden. Sinun on syötettävä jaettu salaisuus, kun määrität Ground Link-välittäjän.
Remoting Service	Timeouts	Aikakatkaisuarvot määrittelevät sekunneissa, kuinka kauan etäkutsut odottavat vastausta. Käytä oletusarvoja. Huomaa: Nämä asetukset eivät ole saatavilla M-Files Cloud -varastoihin.
Keep Alive Interval		Tämä arvo määrittää, kuinka monen sekunnin välein varasto varmistaa, että Ground Link -palvelut ovat yhdistettynä.	60 (oletusarvo)

Valinnainen: Määritä muut asetukset.
Jos haluat lisätietoja, valitse asetus ja katso Info-välilehti.
Napsauta Save.

Varasto käyttää nyt Ground Linkiä ja voit määrittää Ground Link -välittäjän.

Ground Link -välittäjän määrittäminen

Ennen kuin aloitat, varmista, että nämä edellytykset täyttyvät:

Ground Link -välittäjäpalvelimesi vastaa laitteistovaatimuksia. Katso suositeltu laitteistokokoonpano.
M-Files Server ja M-Files Admin on asennettu Ground Link -välittäjäpalvelimelle. M-Files Server ei kuitenkaan vaadi erillistä lisenssiä.
Olet kirjautunut M-Files Serverille käyttäjätilillä, jolla on Järjestelmänvalvoja-palvelinrooli. Katso ohjeet käyttäjätilin luomiseen kohdasta Käyttäjätilin luonti.
Ground Link -välittäjäpalvelimesi saa yhteyden paikallisiin resursseihin (esimerkiksi verkkokansioon tai ulkoiseen tietokantaan), jotka haluat saataville varastoon.

Näin määrität Ground Link -välittäjän Ground Link -välittäjäpalvelimella:

Avaa M-Files Admin.
Laajenna vasemman reunan puunäkymässä M-Files-palvelinyhteys.
Napsauta Ground Link -välittäjät.
Valitse oikeassa sivupaneelissa Uusi Ground Link -välittäjä.
Tulos:Uusi Ground Link -välittäjä -ikkuna avautuu.
Anna Ground Link -välittäjälle nimi.
Valitse tietokantamoottori Ground Link -välittäjän tietojen säilyttämiseen.
- Käytä Firebirdiä valitsemalla Käytä Firebirdiä.
  tai
- Käytä Microsoft SQL Serveriä valitsemalla Käytä Microsoft SQL Serveriä.
Katso lisätietoja kohdasta Tietokantamoottori ja tietovarasto.
Napsauta Määritä.
Tulos:Tietokantamoottorin asetusikkuna avautuu.

Tee yksi näistä vaiheista:

Valinta	Kuvaus
Ground Link -välittäjä - Firebird -ikkunassa	Napsauta ...-painiketta ja valitse Ground Link -välittäjän tiedoille sijainti. Sulje ikkuna napsauttamalla OK.
Ground Link -välittäjä - Microsoft SQL Server -ikkunassa	Tee vaiheet 6–10 kohdassa Ground Link -välittäjän tietokannan siirtäminen Microsoft SQL Serverille.

Sulje Uusi Ground Link -välittäjä -ikkuna napsauttamalla OK.
Asenna juuri luotuun Ground Link -välittäjään ne ulkoisen tietovaraston konnektorit, joita haluat käyttää varastossa.

Huomaa: Jos konnektorille tarvitaan voimassa oleva varastosovelluslisenssi, lisenssi on varastolle ja palvelimelle, jossa varasto on.

Katso lisätietoja kohdasta Dokumenttivarastosovellusten asennus ja hallinta.

Esimerkki: Pääset käyttämään paikallisia verkkokansioita M-Files Cloudista asentamalla M-Files Network Folder Connectorin.

Tulos:Ground Link -välittäjä on nyt valmis määritystä varten.
Valitse vasemman reunan puunäkymän Ground Link -välittäjät -kohdassa juuri luotu Ground Link -välittäjä.

Määritä Configuration-välilehdellä nämä asetukset:


Asetuksen nimi		Kuvaus	Esimerkkiarvo
Enabled		Tämä asetus määrittää, onko Ground Link käytössä vai ei.	Yes
Password		Aseta salasana, jota käytät, kun otat varastossa Ground Link -palvelun määrityksen käyttöön.
Channel	Network Address	Kirjoita yhteyden luonnin kohteena olevan palvelimen sijainti. Jos yhdistät Ground Link -välittäjän M-Files Cloudiin, syötä varaston DNS-nimi.	aa-consulting.cloudvault.m-files.com
	Port number	Kirjoita portti, jota palvelin kuuntelee. Jos yhdistät Ground Link -välittäjän M-Files Cloud -varastoon, käytä porttia 443. Jos käytät gRPC-protokollaa, käytä samaa porttinumeroa kuin M-Files-asiakastietokoneesi käyttää palvelinyhteyttä varten. Katso lisätietoja kohdasta Varastoyhteyden lisääminen. Varmista, että tarvittavat portit ovat auki palomuurissa.	443 tai 7766
	Secure	Tämä asetus määrittää, käytetäänkö varmaa (SSL-salattua) kanavayhteyttä. Tuotantoympäristöissä suojaamattomien yhteyksien käyttöä ei suositella.	Yes
	Vault GUID	Kirjoita varaston GUID-tunniste. Katso varaston GUID-tunniste napsauttamalla varastoa hiiren oikealla painikkeella ja valitsemalla Ominaisuudet. GUID-tunniste näytetään Dokumenttivaraston ominaisuudet -ikkunan Yksilöllinen ID -kentässä.	{990827D8-8AF2-4A4EB1214C1A8AD8ECD0}
	Shared Secret	Kopioi jaettu salaisuus varaston määrityksestä. Kanavayhteyttä ei voida muodostaa, jos jaettu salaisuus ei vastaa yhtä jaetuista salaisuuksista, jotka on määritetty Ground Linkille.
	Reconnect Interval	Tämä arvo määrittää, kuinka monen sekunnin välein Ground Link -välittäjä yrittää luoda yhteyttä, kun yhteys varastoon on katkaistu.	60 (oletusarvo)
	Keep Alive Interval	Tämä arvo määrittää, kuinka monen sekunnin välein Ground Link -välittäjä varmistaa, että yhteys varastoon toimii oikein.	60 (oletusarvo)
	Timeouts	Aikakatkaisuarvot määrittelevät sekunneissa, kuinka kauan etäkutsut odottavat vastausta. Käytä oletusarvoja.
Multi-Server Compatibility	Check Compatibility	Tämä asetus määrittää, tarkastetaanko Multi-Server Mode -yhteensopivuus. Jos yhdistät Ground Link -välittäjän M-Files Cloudiin, käytä asetusta Yes.	Yes (oletusarvo)

Valinnainen: Määritä muut asetukset.
Jos haluat lisätietoja, valitse asetus ja katso Info-välilehti.
Napsauta Save.

Yhteys varaston ja Ground Link -välittäjän välille on muodostettu. Seuraavaksi voit ottaa käyttöön Ground Link -palvelut varastossa.

Varastoyhteyden tilan näet Dashboard-välilehdellä.

Ulkoisten kohdetyyppien määrittäminen Ground Linkin avulla

Tämä esimerkki kertoo, kuinka voit määrittää M-Files OLE DB External Object Type Connectorin varastossa Ground Link -palveluna kohdetyyppien päivittämiseksi ulkoiseen tietovarastoon ja ulkoisesta tietovarastosta. Voit käyttää external object type (EOT) -konnektoria myös arvolistojen kanssa. Ohjeita muiden M-Files EOT -konnektoreiden määrittämiseen löydät M-Files Support Portal -artikkeleista Installing and Configuring M-Files Connector for Salesforce ja Installing and Configuring M-Files Connector for Microsoft Dynamics 365.

Varmista Ground Link -välittäjäpalvelimella, että M-Files OLE DB External Object Type Connector -sovellus on sallittu.

Avaa M-Files Admin.
Laajenna vasemman reunan puunäkymässä M-Files-palvelinyhteys.
Laajenna Ground Link -välittäjät.
Napsauta Ground Link -välittäjää hiiren kakkospainikkeella ja valitse Sovellukset.
Tulos:Sovellukset-ikkuna avautuu.
Etsi sovellusluettelosta M-Files OLE DB External Object Type Connector ja varmista, että sen tila on Otettu käyttöön. Oletusarvoisesti sovellus on estetty.
Sovelluksen käyttöönotto:
1. Valitse M-Files OLE DB External Object Type Connector.
2. Napsauta Ota käyttöön.
3. Käynnistä Ground Link -välittäjä uudelleen napsauttamalla avautuvassa ikkunassa Kyllä.
Sulje Sovellukset-ikkuna napsauttamalla Sulje.
Varmista Ground Link -välittäjän ohjauspaneelissa, että varasto ja ulkoisten kohdetyyppien (EOT) konnektori ovat yhdistettynä:
- Cloud Vault Connection näyttää vihreän ympyrän ().
- Kohdassa Installed Connectors, M-Files OLE DB External Object Type Connector näyttää, että vähintään yksi palvelin on yhdistettynä.
  
  Esimerkiksi:
  
  Huomaa: Kun sovellus on sallittu, ulkoisten kohdetyyppien (EOT) palvelinyhteyden muodostamisessa voi kestää muutamia minuutteja. Päivitä näkymä tarvittaessa napsauttamalla Refresh.

Luo seuraavaksi varastoon kohdetyyppi, joka käyttää ulkoisten kohdetyyppien (EOT) konnektoria:

Avaa M-Files Admin ja siirry varastoon, jossa olet ottanut käyttöön Ground Link -yhteyden.
1. Avaa M-Files Admin.
2. Laajenna vasemman reunan puunäkymässä M-Files-palvelinyhteys.
3. Laajenna Dokumenttivarastot.
4. Laajenna varasto.
Laajenna Metatietojen rakenne (tasainen näkymä).
Valitse Kohdetyypit.
Valitse tehtäväalueella Uusi kohdetyyppi.
Tulos:Kohdetyypin ominaisuudet -ikkuna avautuu.
Määritä tiedot välilehdillä Yleiset, Lisäasetukset ja Suojausasetukset. Katso ohjeet kohdasta Uuden kohdetyypin luonti.

Määritä lopuksi yhteys ulkoiseen tietokantaan:

Avaa Kohdetyypin ominaisuudet -ikkunassa Yhteys ulkoiseen tietokantaan -välilehti ja valitse Käytä yhteyttä ulkoiseen tietokantaan tuodaksesi ja muokataksesi kohteita, jotka ovat ulkoisessa tietokannassa.
Valitse Sovelluksella muodostettava yhteys.
Kohdassa Palvelu, valitse M-Files OLE DB Ground Link -välittäjältä <Ground Link -välittäjän nimi>.
Napsauta Määritä.
Jos M-Files kysyy haluatko luoda kohdetyypin, valitse Kyllä.
Määritä yhteys ulkoiseen tietokantaan avatussa External Object Type Connector -ikkunassa. Katso ohjeet kohdasta Kohdetyypit ja niiden yhteydet ulkoisiin tietokantoihin.
Varmista määritysten tallentamisen jälkeen, että yhteys toimii virheettömästi:
1. Testaa SELECT-lauseen toiminta napsautamalla ikkunan oikeassa yläkulmassa Test Select. Jos testi onnistuu, M-Files näyttää yhteenvedon ominaisuuskohdennuksista. Jos testi epäonnistuu, näytetään virheet. Muokkaa tässä tapauksessa määrityksiä ja yritä uudestaan.
2. Varmista, ettei ikkunan vasemman alakulman Local- ja Server-välilehdillä ole virheitä. Jos virheitä on, ratkaise ne annettujen ohjeiden avulla.
Sulje External Object Type Connector -ikkuna napsauttamalla Sulje.
Napsauta OK Kohdetyypin ominaisuudet -ikkunassa.

Kohdetyyppi päivitetään nyt ulkoiseen tietokantaan ja ulkoisesta tietokannasta.

Ground Link -konnektorien määrittäminen

Tämä esimerkki kertoo, kuinka voit määrittää M-Files Network Folder Connector -konnektorin varastossa Ground Link -palveluna. Jos haluat lisätietoa muiden konnektoreiden tuesta, ota yhteyttä asiakastukeemme osoitteessa M-Files Support Portal tai M-Files-jälleenmyyjääsi.

Ennen kuin aloitat, varmista, että M-Files Network Folder Connector on asennettu Ground Link -välittäjään, joka on liitetty varastoosi.

Määritä yhteys Ground Link -välittäjään näin:

Avaa M-Files Admin ja siirry varastoon, jossa olet ottanut käyttöön Ground Link -yhteyden.
1. Avaa M-Files Admin.
2. Laajenna vasemman reunan puunäkymässä M-Files-palvelinyhteys.
3. Laajenna Dokumenttivarastot.
4. Laajenna varasto.
Valitse Määritykset.
Laajenna harmaalla navigointialueella External Repositories.
Napsauta Ground Link.

Dashboard-välilehdellä näet liitetyt Ground Link -välittäjät ja käytettävissä olevat Ground Link -palvelut. Varmista, että palvelu, jonka haluat määrittää, eli tässä tapauksessa Network Folder, on yhteydessä verkkoon.
Laajenna harmaalla navigointialueella ensin Ground Link-solmu ja sitten Ground Link -välittäjä, jonka palvelua haluat käyttää.
Valitse harmaalla navigointialueella Ground Link -palvelu, eli tässä tapauksessa Network Folder.
Valitse Dashboard-välilehdellä Add Connection.
Napsauta avautuvassa vahvistusikkunassa OK.
Määritä uusi yhteys napsauttamalla Dashboard -välilehdellä Configure.
Katso lisätietoja dokumentista Installing and Configuring M-Files Network Folder Connector.
Napsauta Save.
Napsauta Apply.
Tulos:Enter Password -ikkuna avautuu.
Anna salasana, joka on määritetty Ground Link -välittäjämäärityksessä.
Valinnainen: Todenna taustakäyttäjät. Kun olet antanut tunnistetiedot, tallenna ja ota asetukset käyttöön uudelleen.
Katso lisätietoja dokumentista Installing and Configuring M-Files Network Folder Connector.
Napsauta Save.
Valinnainen: Lisää enemmän yhteyksiä toistamalla vaiheet 5–12.

Nyt pääset käyttämään paikallisia verkkokansioita varastosta. Verkkokansioiden kohteet näytetään M-Filesissa. Voit muokata niitä ja antaa niille metatietoja samalla tavalla kuin varastoon tallennettujen kohteiden tapauksessa.