SFTP-tiedonsiirtoa tarvitaan tiedostojen siirtämiseksi palvelimelle. SFTP-palvelimena voidaan käyttää joko asiakkaan tai toimittajan (kumppani tai Nepton) SFTP-palvelinta.
Nepton ottaa yhteyden SFTP-asetuksissa määritellyllä tavalla asetetun ajastuksen mukaisesti. Nepton kirjautuu SFTP-palvelimelle käyttäjätunnuksella ja salasanalla, jotka ovat saatu SFTP-toimittajalta. Asiakkaan tulee huolehtia tarpeellisista palomuuriavauksista tiedonsiirron onnistumiseksi omista lähde- tai kohdejärjestelmistään. Lisätietoa näistä vaatimuksista saat tukipalvelun artikkelista täältä.
Kansio- tai tiedostonimissä ei tueta erikoismerkkejä, eikä skandinaavisia merkkejä.
SFTP-palvelimen määrittäminen Työsuhde-osiossa
Tiedostopalvelimen tiedot löytyvät valikosta Työsuhde -> Hallinta -> Ajastetut tehtävät -> Lisää tehtävä.
Työsuhde-osiossa määritetään sekä viennin että tuonnin asetukset.
SFTP-palvelimen omistajan tulee huolehtia palvelimen osoitteesta ja käyttäjätunnuksista.
SFTP-siirtojen portti on tavallisesti 22.
Työkansio määritetään suhteellisena polkuna kirjautumisen jälkeen avautuvaan kansioon, esimerkiksi "in".
Käsiteltyjen tuontitiedostojen arkistointikansio määritetään vastaavasti, esimerkiksi "to_nepton/processed". Kummassakaan tapauksessa "-merkkejä ei kirjoiteta polkuun. Tieto on pakollinen.
SFTP-palvelimen määrittäminen Työaika-osiossa
Tapahtumatietojen ja projektitietojen tuonnissa Nepton kirjautuu SFTP-palvelimelle joko käyttäjätunnuksella tai Nepton-palvelun julkisella varmenteella (''Public Key'').
Mikäli siirto halutaan ajastaa, on asetukset määritettävä Työyhteisön asetukset-tasolla Liittymien ajastus-kohdassa.
Oletuksena portti on 22. Tähän voidaan myös määrittää eri portti SFTP-palvelimen osoite-kentässä, esimerkiksi "192.168.0.1:22" ohjaa porttiin 22.
Tapahtumien tuonti
Tapahtumien tuonnin asetukset löytyvät valikosta Työaika -> Työyhteisön asetukset -> Liittymät -> Tapahtumien tuonti.
SFTP suhteellisen hakemiston polku määritetään suhteellisena polkuna kirjautumisen jälkeen avautuvaan kansioon, esimerkiksi "in".
SFTP arkistoinnin suhteellisen hakemiston polku määritetään vastaavasti, esimerkiksi "to_nepton/processed". Kummassakaan tapauksessa "-merkkejä ei kirjoiteta polkuun.
Projektien tuonti
Projektien tuonnin asetukset löytyvät valikosta Työaika -> Työyhteisön asetukset -> Liittymät -> Projektien tuonti.
SFTP suhteellisen hakemiston polku määritetään suhteellisena polkuna kirjautumisen jälkeen avautuvaan kansioon, esimerkiksi "in".
SFTP arkistoinnin suhteellisen hakemiston polku määritetään vastaavasti, esimerkiksi "to_nepton/processed". Kummassakaan tapauksessa "-merkkejä ei kirjoiteta polkuun.
Työaika-osion vienneissä SFTP-palvelimen määrittäminen tehdään erikseen kutakin vientiä koskien.
SFTP-käyttäjätunnuksen määrittely
Palvelusta on mahdollista kirjautua SFTP-palvelimelle kahdella eri tavalla. Perinteinen käyttäjätunnus/salasana-yhdistelmä on yleisimmin käytetty tapa. Toinen tapa on kirjautua käyttäen Public Key-autentikointia. Tarkempi ohje löytyy täältä.
Huom. Molemmat tavat eivät voi olla yhtä aikaa käytössä.
Palvelu käyttää stage-kansiota aineiston muodostamisen aikaisena työkansiona ja kyseinen kansio toimii määritetyn työkansion alikansiona.
Huomioithan, että käyttäjätunnus tarvitsee riittävät oikeudet työkansioon sekä sen alikansioihin:
- Tiedostojen luonti
- Tiedostojen poisto
Mikäli oikeudet eivät ole riittävät, voi Nepton palauttaa esimerkiksi alla olevan kaltaisen virheilmoituksen. Virheilmoitus viittaa siihen, että Neptonilla ei ole oikeuksia luoda uutta kansiota palvelimelle:
SFTP-arkistointi
Palvelussa on mahdollista arkistoida käsiteltyjä tuontitiedostoja. Tätä varten pitää luoda arkistoinnin kansio ja määrittää tämän kansion polku palvelussa. Arkistoinnin kansioon muodostuu automaattisesti VUOSI-KK muotoisia alakansioita, johon arkistoitavat tiedostot siirretään.
Jos tiedoston tuonti epäonnistuu kokonaan virheiden takia, ei kyseistä tiedostoa arkistoida. Tällä tavoin estämme ongelmat, joita saattaa aiheutua, jos aikaisempi (epäonnistunut) tiedosto sisältää tietoja, jotka ovat kriittisiä myöhemmille tiedostoille. On monia muitakin käyttötapauksia, joissa tämä voi aiheuttaa ongelmia.
Huomioithan, että mikäli arkistointi on käytössä, käyttäjätunnus tarvitsee riittävät oikeudet arkistokansioon
- Tiedostojen luonti
- Tiedostojen poisto
- Kansioiden luonti
- Kansioiden poisto
Mikäli oikeudet eväti ole riittävät, voi Nepton palauttaa esimerkiksi alla olevan kaltaisen virheilmoituksen. Virheilmoitus viittaa siihen, että Neptonilla ei ole oikeuksia luoda uutta kansiota palvelimelle: