Kohdetyypit ja niiden yhteydet ulkoisiin tietokantoihin

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.
  • 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.
  • SELECT FROM -lauseissa sarakkeet valitaan ilmestymisjärjestyksessä. Sarakkeiden ja ominaisuuksien nimien välillä ei ole yhteyttä, minkä vuoksi järjestyksen on oltava sama SELECT FROM ja INSERT INTO -lauseissa sekä SELECT FROM ja UPDATE -lauseissa. Lisäksi kaikki sarakkeet, joita ei käytetä INSERT INTO ja UPDATE-lauseissa on listattava viimeisenä SELECT FROM -lauseessa.

Käyttääksesi yhteyttä ulkoiseen tietokantaan ja avataksesi palvelun määritykset:

  1. 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.
  2. Laajenna Metatietojen rakenne (tasainen näkymä).
  3. Napsauta Kohdetyypit.
    Tulos:kohdetyyppi -listaus avautuu oikeaan sivupaneeliin.
  4. Oikean sivupaneelin listauksessa, valitse kohdetyyppi ja kaksoisnapsauta sitä.
    Tulos:Kohdetyypin ominaisuudet -ikkuna avautuu.
  5. Avaa Yhteys ulkoiseen tietokantaan -välilehti ja valitse Käytä yhteyttä ulkoiseen tietokantaan tuodaksesi ja muokataksesi kohteita, jotka ovat ulkoisessa tietokannassa.
  6. Valitse Sovelluksella muodostettava yhteys.
  7. Kohdassa Palvelu, valitse palvelu.
    ValintaKuvaus
    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.
  8. Napsauta Määritä.
    Tulos:External Object Type Connector -ikkuna avautuu.
Määrittääksesi yhteysasetukset ja saadaksesi lähdesarakkeet:
  1. Laajenna Service-Specific Settings > Connection to External Database.
  2. 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.
  3. Valinnainen: Jos valitsit Custom provider -asetuksen arvoksi Custom provider (manual configuration), määritä tarjoaja.
  4. Tee yksi näistä vaiheista osiossa Connection to External Database:
    ValintaKuvaus
    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.
  5. 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ä.
  6. 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.
  7. Napsauta Save.
  8. Valinnainen: Määrittääksesi etäpalvelun:
    1. Napsauta Apply.
      Tulos:Enter Password -ikkuna avautuu.
    2. Anna salasana, joka on määritetty Ground Link -välittäjämäärityksessä.
    3. Napsauta OK.
  9. Todenna yhteinen käyttäjä avaamalla Dashboard-välilehti ja napsauttamalla Authenticate.
    Tulos:Log In -ikkuna avautuu.
  10. 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}.
  11. Napsauta avautuvassa ikkunassa OK.
  12. Napsauta Save, jotta lähdesarakkeet haetaan.
    1. 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:
  1. Siirry Configuration-välilehdellä osioon Column Mappings ja laajenna lähdesarakesolmu.
  2. 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.

  3. 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.
    Jos haluat...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ä
    1. Anna asetukselle Use in Update Operation arvo Yes.
    2. Kirjoita Service-Specific Settings -osion kohtaan UPDATE statement UPDATE-tietokantalause.
    Salli käyttäjien päivittää, luoda ja poistaa tietoja
    1. Anna asetuksille Use in Update Operation ja Use in Insert Operation arvo Yes.
    2. Kirjoita Service-Specific Settings -osiossa tässä taulukossa annetut neljä lausetta.
    Lause Kuvaus Esimerkit
    UPDATE Kun käyttäjä muokkaa kohdetta M-Filesissa, M-Files Server käyttää UPDATE-lausetta muokatakseen vastaavaa tietuetta ulkoisessa tietokannassa. Merkitse kysymysmerkillä (?) kaikkien päivitettävien sarakkeiden arvot.
    Huomaa: Varmista, että sarakkeet ovat samassa järjestyksessä kuin SELECT-lauseessa.

    UPDATE Customers SET CustomerName = ? WHERE CustomerID = ?

    UPDATE Contact SET Name = ?, CustomerID = ? WHERE ContactID = ?
    INSERT INTO Kun käyttäjä luo uuden kohteen M-Filesiin, M-Files Server käyttää INSERT INTO -lausetta lisätäkseen vastaavan uuden tietueen ulkoiseen tietokantaan. Käytä kysymysmerkkiä (?) osoittamaan jokaisen sarakkeen arvoa.
    Huomaa: Varmista, että sarakkeet ovat samassa järjestyksessä kuin SELECT-lauseessa.
    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 luodun tietueen ID-arvon tällä SELECT-lauseella.

    SELECT MAX( CustomerID ) FROM Customer

    SELECT ID FROM Customers WHERE CustomerName = ?

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

    DELETE FROM Customers WHERE CustomerID = ?

    DELETE FROM Contacts WHERE ContactID = ?
  4. Toista vaiheet 21–23 tarvittaville lähdesarakkeille.
Ottaaksesi määritykset käyttöön:
  1. 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.

  2. Valinnainen: Määrittääksesi etäpalvelun:
    1. Napsauta Apply.
      Tulos:Enter Password -ikkuna avautuu.
    2. Anna salasana, joka on määritetty Ground Link -välittäjämäärityksessä.
    3. Napsauta OK.
  3. Sulje Kohdetyypin ominaisuudet -ikkuna napsauttamalla OK.
Valittu kohdetyyppi päivitetään nyt ulkoiseen tietokantaan ja ulkoisesta tietokannasta.