Voit asettaa M-Filesin päivittämään kohdetyypit ulkoiseen tietokantaan tai ulkoisesta tietokannasta. Ulkoista tietokantayhteyttä käyttävät kohteet voivat sisältää myös ominaisuuksia, joita ei ole synkronoitu ulkoisen tietokannan kanssa.
Tässä osiossa kerrotaan, miten voit asettaa kohdetyypit käyttämään sovelluksella muodostettua yhteyttä ulkoiseen tietokantaan. Jos haluat käyttää perinteistä tietokantayhteyttä, katso osio ”Perinteisen tietokantayhteyden käyttö (Kohdetyypit)”.
Edellytykset
Huomioi nämä tärkeät tiedot ennen asennuksen aloittamista:
- Ennen kuin määrität sovellusyhteyden ulkoiseen tietokantaan, konnektori ulkoisille kohdetyypeille tulee olla asennettu ja otettu käyttöön.
- Konnektorin täytyy tukea sovelluksella muodostettavaa yhteyttä. Voit käyttää M-Files
OLE DB External Object Type Connectoria, joka on yleensä asennettu varastoon, mutta on poistettu käytöstä.
- Jos käytät Ground Link -palvelua, konnektori on otettava käyttöön Ground Link -välittäjässä. Katso ohjeet kohdasta Ulkoisten kohdetyyppien määrittäminen Ground Linkin avulla. Jos käytät paikallista palvelua, konnektori on otettava käyttöön varastossa.
- Jos käytät replikointia ja sovelluksella muodostettavaa yhteyttä ulkoiseen tietokantaan, sinun on määritettävä yhteys jokaiselle replikoitavalle varastolle erikseen. Varmista, että tarvittavat määritysmuutokset tehdään myös jokaiseen varastoon. Suosittelemme myös, että luet osion Replication of External
Objects asiakirjasta Replication and Archiving - User's Guide.
- Replikointipaketteihin ei ole mahdollista sisällyttää määritystä External
Object Type Connectorille.
Käyttääksesi yhteyttä ulkoiseen tietokantaan ja avataksesi palvelun määritykset:
-
Avaa M-Files Admin ja siirry varastoon.
-
Avaa M-Files Admin.
-
Laajenna vasemman reunan puunäkymässä M-Files-palvelinyhteys.
-
Laajenna Dokumenttivarastot.
-
Laajenna varasto.
-
Laajenna Metatietojen rakenne (tasainen näkymä).
-
Napsauta Kohdetyypit.
Tulos:kohdetyyppi -listaus avautuu oikeaan sivupaneeliin.
-
Oikean sivupaneelin listauksessa, valitse kohdetyyppi ja kaksoisnapsauta sitä.
Tulos:Kohdetyypin ominaisuudet -ikkuna avautuu.
-
Avaa 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 palvelu.
Valinta | Kuvaus |
---|
M-Files OLE DB varastossa <varaston nimi> |
Valitse tämä vaihtoehto, jos käytät paikallista palvelua. |
M-Files OLE DB Ground Link -välittäjältä <Ground Link -välittäjän nimi> |
Valitse tämä vaihtoehto muodostaaksesi yhteyden käyttämällä etäpalvelua Ground Linkin kautta. |
Jos palvelun perässä lukee (OK), se on määritetty metatietoelementille kohdetyyppi.
Tulos:Tiedot palvelun määrityksestä ja mahdollisista virheistä näytetään.
-
Napsauta Määritä.
Tulos:External Object Type Connector -ikkuna avautuu.
Määrittääksesi yhteysasetukset ja saadaksesi lähdesarakkeet:
-
Laajenna .
-
Kohdassa Provider, valitse ulkoisen tietokantayhteyden tarjoaja.
Esimerkki:Microsoft OLE DB Driver for SQL
Server.
Huomaa: Luettelo näyttää kaikki tarjoajat, jotka ovat saatavilla konnektoria ylläpitävällä palvelimella. Se voi siis sisältää tarjoajia, joita ei voida käyttää yhteyksissä ulkoisiin tietokantoihin.
Yhteysmerkkijonon syntaksi on erilainen jokaisella
Object Linking and Embedding Database (
OLE DB) -tarjoajalla, jota käytetään muodostettaessa yhteys ulkoiseen tietokantaan. Jos yhteyden muodostaminen vaatii
Open Database Connectivity (
ODBC) -rajapinnan käyttöä, tietosäilöön on yhdistettävä käyttämällä
OLE DB:tä ja
ODBC:tä. Katso luettelo suositelluista palveluntarjoajista kohdasta
Suositellut ulkoisten tietokantayhteyksien tarjoajat.
- Valinnainen:
Jos valitsit Custom provider -asetuksen arvoksi Custom provider (manual
configuration), määritä tarjoaja.
-
Tee yksi näistä vaiheista osiossa Connection to External Database:
Valinta | Kuvaus |
---|
Määritä muut asetukset. |
Arvot ovat erilaiset jokaisella tarjoajalla ja ulkoisella tietokannalla.
Jos haluat lisätietoja, valitse asetus ja katso Info-välilehti.
|
Syötä yhteysmerkkijono arvoksi asetukselle Advanced Options. |
Käytä tätä vaihtoehtoa, jos et voi käyttää muita asetuksia valitulle palveluntarjoajalle. Kun syötät yhteysmerkkijonon, varmista, että kaikki arvot on eroteltu oikein ja että yhteysmerkkijono on oikein muodostettu. |
- Valinnainen:
Määritä Optional SELECT Statements -osion asetukset.
Huomaa: Sovelluksella muodostettava yhteys ei tue M-Files Adminin Advanced Vault Settings -osion Connections to
External Databases -asetuksia. Käyttääksesi näitä asetuksia määritä ne tässä.
-
Kirjoita Service-Specific Settings -osion SELECT Statement -asetuksen arvoksi SELECT-tietokantalause lähdesarakkeiden lukemiseksi ulkoisesta tietokannasta.
Esimerkkejä
SELECT-tietokantalauseesta:
SELECT CustomerNumber, CustomerName FROM Customer
SELECT ID, Name + ' ' + Department FROM Company
SELECT ID, Name, CustomerID FROM Contacts
SELECT * FROM Customer
Vihje: Voit käyttää monirivisiä tietokantalauseita.
-
Napsauta Save.
- Valinnainen:
Määrittääksesi etäpalvelun:
-
Napsauta Apply.
Tulos:Enter
Password -ikkuna avautuu.
-
Anna salasana, joka on määritetty Ground Link -välittäjämäärityksessä.
-
Napsauta OK.
-
Todenna yhteinen käyttäjä avaamalla Dashboard-välilehti ja napsauttamalla Authenticate.
Tulos:Log In -ikkuna avautuu.
-
Syötä yhteisen käyttäjän tunnistetiedot ja napsauta Log
In.
Huomaa: ODBC-ajuri ei tue kaikkia erikoismerkkejä. Jos yhteytesi käyttää ODBC:tä, erikoismerkkejä sisältävät arvot on merkittävä aaltosulkeiden sisään. Oikea muoto on {käyttäjänimi tai salasana}.
-
Napsauta avautuvassa ikkunassa OK.
-
Napsauta Save, jotta lähdesarakkeet haetaan.
- Valinnainen:
Määrittääksesi etäpalvelun toista vaihe16.
Huomaa: Jos määritysmuutoksia ei ole, et voi tallentaa määrityksiä.
Tulos:Ikkuna sulkeutuu ja määritykset päivittyvät. Configuration-välilehden Column
Mappings -osio näyttää lähdesarakkeet, jotka SELECT-tietokantalauseesi haki ulkoisesta tietokannasta.
Kohdentaaksesi lähdesarakkeet M-Files-ominaisuuksiin:
-
Siirry Configuration-välilehdellä osioon Column Mappings ja laajenna lähdesarakesolmu.
-
Määritä Mapping Type -asetuksella, miten lähdesarake kohdennetaan M-Filesissa. Tee yksi näistä vaiheista:
- Kohdenna lähdesarake ulkoiseen tunnisteeseen valitsemalla Object ID.
tai
- Kohdenna lähdesarake M-Files-ominaisuuteen valitsemalla Property. Valitse Target Property -asetuksen arvoksi haluttu M-Files-ominaisuus.
Huomaa: Kun haluat määrittää useita arvoja tietotyypille
Valitse listasta (monivalinta), arvot on tallennettava omille riveilleen ulkoiseen tietokantaan. Jos esimerkiksi haluat kohdentaa useita arvoja
Industry-ominaisuudelle, arvot on tallennettava näin:
ID |
Customer name |
City |
Industry |
Active |
ABC-123 |
ESTT Corporation |
New York |
100 |
1 |
ABC-123 |
ESTT Corporation |
New York |
101 |
1 |
ABC-123 |
ESTT Corporation |
New York |
108 |
1 |
Tässä tapauksessa tietoa voi kuitenkin vain lukea ulkoisesta tietokannasta, ei tallentaa sinne.
- Valinnainen:
Jos Mapping Type -asetuksen arvo on Property, määritä asetukset Use in Update Operation ja Use in Insert Operation sekä niihin liittyvät tietokantalauseet.
Tavoite: | Toimi seuraavasti: |
---|
Salli vain luku -käyttö |
Anna asetuksille Use in Update
Operation ja Use in Insert
Operation arvo No. Älä määritä tässä taulukossa annettuja tietokantalauseita. |
Salli käyttäjien päivittää tietoja, mutta ei luoda tai poistaa niitä |
- Anna asetukselle Use in Update
Operation arvo Yes.
- Kirjoita Service-Specific
Settings -osion kohtaan UPDATE
statement UPDATE-tietokantalause.
|
Salli käyttäjien päivittää, luoda ja poistaa tietoja |
- Anna asetuksille Use in Update
Operation ja Use in
Insert Operation arvo Yes.
- Kirjoita Service-Specific
Settings -osiossa tässä taulukossa annetut neljä tietokantalausetta.
|
Lause |
Kuvaus |
Esimerkit |
UPDATE |
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. |
UPDATE Customers SET CustomerName = ?
WHERE CustomerID = ?
UPDATE Contact SET Name = ?,
CustomerID = ? WHERE ContactID = ?
|
INSERT INTO |
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. Huomaa: M-Filesiin syötettävässä INSERT INTO -lauseessa ei määritellä arvoa ID-sarakkeelle. Ulkoisen tietokannan tulee toimia siten, että se tuottaa uudelle tietueelle ID-arvon automaattisesti. Tämä onnistuu esimerkiksi SQL Server -tietokannassa määrittelemällä ID-sarake identity-tyyppiseksi. Jos ulkoinen tietokanta ei pysty tuottamaan uusia ID-arvoja, INSERT
INTO -lauseketta ei voida käyttää. |
INSERT INTO Customers( CustomerName )
VALUES( ? )
INSERT INTO ContactPersons( Name,
CustomerID ) VALUES( ?, ? )
|
Get ID SELECT |
Kun uusi tietue on luotu INSERT INTO -lauseella, M-Files Server hakee juuri luodun tietueen ID-arvon tällä SELECT-lauseella. |
SELECT MAX( CustomerID ) FROM
Customer
|
DELETE |
Kun poistat kohteen M-Filesista, M-Files Server käyttää DELETE-tietokantalausetta poistaakseen vastaavan tietueen ulkoisesta tietokannasta. Merkitse kysymysmerkillä (?) poistettavan kohteen ID. |
DELETE FROM Customers WHERE CustomerID
= ?
DELETE FROM Contacts WHERE ContactID =
?
|
-
Toista vaiheet 21–23 tarvittaville lähdesarakkeille.
Ottaaksesi määritykset käyttöön:
-
Aseta General Settings -osiossa Enabled-asetuksen arvoksi Yes.
Vihje: Yhteyden ulkoiseen tietokantaan voi ottaa käyttöön tai poistaa käytöstä myös käyttämällä
Kohdetyypin ominaisuudet -ikkunan
Yhteys ulkoiseen tietokantaan -välilehdellä olevaa
Ei käytössä -valintaa.
Jos yhteys on poistettu käytöstä, tietoja varaston ja ulkoisen tietokannan välillä ei synkronoida.
- Valinnainen:
Määrittääksesi etäpalvelun:
-
Napsauta Apply.
Tulos:Enter
Password -ikkuna avautuu.
-
Anna salasana, joka on määritetty Ground Link -välittäjämäärityksessä.
-
Napsauta OK.
-
Sulje Kohdetyypin ominaisuudet -ikkuna napsauttamalla OK.
Valittu kohdetyyppi päivitetään nyt ulkoiseen tietokantaan ja ulkoisesta tietokannasta.