Yhteys ulkoiseen tietokantaan

Yhteys ulkoiseen tietokantaan -välilehdellä voit määrittää kohdetyypin, joka käyttää yhteyttä ulkoiseen tietokantaan.

Huomautus: Ulkoisia kohdetyyppejä voidaan tavallisesti lisätä tai muokata käyttäjätileillä, joilla on Järjestelmänvalvoja-palvelinrooli. Lisäksi varaston käyttäjille, joilla on oikeuksina Täysi dokumenttivaraston hallintaoikeus tai Metatietojen rakenteen muuttaminen, voidaan määrittää oikeudet muokata ja lisätä ulkoisia kohdetyyppejä. Kysy lisätietoja M-Files-asiakastuesta.

Uusi kohdetyyppi -valintaikkunan Yhteys ulkoiseen tietokantaan -välilehti.

Käytä yhteyttä ulkoiseen tietokantaan tuodaksesi ja muokataksesi kohteita, jotka ovat ulkoisessa tietokannassa

Ottaa toiminnon käyttöön. Voit määritellä M-Filesin ottamaan yhteyden esimerkiksi organisaation asiakastietokantaan.

OLE DB -yhteysmääritys (palvelimelta)

M-Files Server käyttää yhteysmääritystä muodostaakseen OLE DB -yhteyden ulkoiseen tietokantaan. Yhteysmäärityksen syntaksi riippuu OLE DB -tarjoajasta, jota käytetään yhteydessä ulkoiseen tietokantaan. Jos tietovarastoon saadaan yhteys vain ODBC:n avulla, niin tällöin tietovarastoa pitää käyttää OLE DB:n ja ODBC:n kautta. Tarkka yhteysmääritys riippuu käytetystä tietokannasta.

Huomaa, että teknisistä syistä johtuen M-Files Adminissa näytetään ne OLE DB -tarjoajat, jotka ovat saatavilla sillä tietokoneella, jossa M-Files Admin -työkalua suoritetaan. M-Files Server voi kuitenkin sijaita eri tietokoneella. Varmista, että valittu OLE DB -yhteysmääritys toimii juuri M-Files-palvelimelta.

Huomautus: JET-ajuri on usein 32-bittinen ja toimii M-Files Server -palvelinta ajettaessa 32-bittisessä tilassa.

Suosituksia sopivista tarjoajista

Tietokanta	Tarjoaja
MS SQL Server	Microsoft OLE DB Provider for SQL Server.
Access	Microsoft JET OLE DB Provider.
Excel	Microsoft JET OLE DB Provider. Lisäksi tulee määritellä Extended Properties -kohdalle arvoksi ”Excel 8.0;”. Excel-taulukkoon tulee määritellä data-alue Määritä nimi -toiminnolla. Tällainen nimetty data-alue Excelissä vastaa tietokannan taulua. Taulun sarakkeiden niminä käytetään data-alueen ensimmäisen rivin arvoja.
MySQL	Microsoft OLE DB Provider for ODBC Drivers (MySQL Connector/ODBC). Muodosta uusi järjestelmätietolähde valvontatyökaluista löytyvän Tietolähteet (ODBC) -työkalun avulla. Valitse ODBC-ajuriksi MySQL Connector/ODBC. Määrittele tietolähde. Laita ajurin ominaisuuksista päälle kohta Disable Transactions. Valitse yhteysmäärityksessä tarjoajaksi Microsoft OLE DB Provider for ODBC Drivers ja tietolähteeksi määrittelemäsi järjestelmätietolähde. Yhteysmäärityksen alkuperäinen luettelo jätetään tyhjäksi. Tietokanta määritellään siis vain ajurin määrittelyssä. MySQL:n kanssa voi myös käyttää MySql.OLEDB Provider -nimistä tarjoajaa

SELECT-tietokantalause

M-Files Server käyttää SELECT-tietokantalausetta hakeakseen tietueita ulkoisesta tietokannasta.

Esimerkkejä SELECT-tietokantalauseesta:

SELECT AsiakasNumero, AsiakasNimi FROM Asiakkaat

SELECT ID, Nimi + ' ' + Osasto FROM Yhtiot

SELECT ID, Nimi, AsiakasID FROM Yhteyshenkilot

SELECT * FROM Asiakas

Päivitä sarakkeet

Hakee SELECT-tietokantalauseen määrittelemät tiedot Sarakkeet-kohtaan.

Sarakkeet

Sarakkeet-kohdassa näkyvät vastaavuudet ulkoisesta tietokannasta haettujen sarakkeiden ja dokumenttivaraston ominaisuusmäärittelyjen välillä. Voit muokata lähdesarakkeiden ja kohdeominaisuuksien vastaavuuksia. Kohdetyypillä tulee aina olla vastaavuudet yksilölliseen tunnisteeseen (ID) ja nimeen. Alityypeillä tulee myös löytyä sarakeyhteys omistajakohteeseen. Jos kenttä on päivitettävissä UPDATE-tietokantalauseella ulkoisessa tietokannassa, voit määritellä Päivitä-kohtaan merkinnän tästä. Lisää-kohdalla määritellään ne kentät, joita voidaan lisätä INSERT INTO -tietokantalauseella ulkoiseen tietokantaan.

UPDATE-tietokantalause

Kun muokkaat kohdetta M-Filesissa, M-Files Server käyttää UPDATE-tietokantalausetta muokatakseen vastaavaa tietuetta ulkoisessa tietokannassa. Merkitse kysymysmerkillä (?) kaikkien päivitettävien sarakkeiden arvot.

Esimerkkejä UPDATE-tietokantalauseesta:

UPDATE Asiakkaat SET AsiakasNimi = ? WHERE AsiakasID = ?

UPDATE Yhteyshenkilo SET Nimi = ?, AsiakasID = ? WHERE YhteyshenkiloID = ?

INSERT INTO -tietokantalause

Luodessasi uutta kohdetta M-Filesiin M-Files Server käyttää INSERT INTO -tietokantalausetta lisätäkseen vastaavan uuden tietueen ulkoiseen tietokantaan. Käytä kysymysmerkkiä (?) osoittamaan jokaisen sarakkeen arvoa.

Esimerkkejä INSERT INTO -tietokantalauseista:

INSERT INTO Asiakkaat( AsiakkaanNimi ) VALUES( ? )

INSERT INTO Yhteyshenkilot( Nimi, AsiakkaanID ) VALUES( ?, ? )

Huomautus: M-Filesiin syötettävässä INSERT INTO -lauseessa ei määritellä arvoa ID-sarakkeelle. Tietokannan tulee toimia siten, että se tuottaa uudelle tietueelle ID-arvon automaattisesti. Esim. SQL Server -tietokannassa tämä onnistuu määrittelemällä ID-sarake identity-tyyppiseksi ja Access-tietokannassa käyttämällä AutoNumber-tyyppistä ID-saraketta. Excelin kanssa INSERT INTO -lausetta ei voi käyttää, koska uuden ID-arvon tuottaminen ei Excelillä onnistu.

DELETE-tietokantalause

Kun poistat kohteen M-Filesista, M-Files Server käyttää DELETE-tietokantalausetta poistaakseen vastaavan tietueen ulkoisesta tietokannasta. Merkitse kysymysmerkillä (?) poistettavan kohteen ID.

Esimerkkejä DELETE-tietokantalauseesta:

DELETE FROM Asiakkaat WHERE AsiakasID = ?

DELETE FROM Yhteyshenkilot WHERE YhteyshenkiloID = ?

Ei käytössä

Ulkoinen yhteys voidaan tilapäisesti poistaa käytöstä merkitsemällä Ei käytössä -valintaruutu.