Mae Porth CSV yn ddull o awtomeiddio mewnforio ffeiliau CSV i Canvas. Caiff ffeiliau eu trosglwyddo gan ddefnyddio Protocol Trosglwyddo Ffeiliau Diogel (SFTP). Gall Porth CSV fod yn arbennig o ddefnyddiol os nad oes gan eich SIS gysylltiad integreiddio API uniongyrchol â Canvas.
Os oes gennych ddiddordeb mewn sefydlu Porth CSV/SFTP ar gyfer darparu data neu allforio graddau, cysylltwch â'ch Rheolwr Llwyddiant Cwsmeriaid (CSM) Instructure.
Yr hyn y dylech chi ei wybod
- Rhaid i ffeiliau CSV fod wedi'u halinio â chanllawiau fformat CSV Canvas. Mae rhagor o wybodaeth am fformatio CSV Canvas ynein canllaw.
- Mae rheolau safonol CSV yn berthnasol:
- Dehonglir y rhes gyntaf fel y pennawd ac mae'n orfodol.
- Rhaid i'r holl destun yn y ffeil fod wedi'i amgodio ag UTF-8
- Dylai pob stamp amser fod wedi'i fformatio yn ôl ISO 8601. Mae pob stamp amser yn ddiofyn i UTC oni bai bod gwrthbwyso parth amser wedi'i nodi.
- Nid yw mewnforion yn digwydd mewn amser real. Mae swyddi cysoni wedi'u hamserlennu. Bydd amlder yn dibynnu ar eich set ddata a gellir trafod hyn ymhellach gyda'ch Ymgynghorydd Instructure. Mae'r rhan fwyaf o gysoni wedi'u hamserlennu cyffredin unwaith neu ddwywaith y dydd.
- DewisolAdroddiad Allforio Graddaugellir ei drefnu i gael ei osod yn y porth unwaith y dydd.
- AGwahaniaethuGellir ffurfweddu'r cyfeiriadur ar gais. Bydd mewnforion gwahanol yn chwilio am newidiadau yn y ffeiliau a ddanfonwyd ac yn cymryd camau gweithredu ar unrhyw gofnodion sydd ar goll. Os oes gennych ddiddordeb mewn cael hyn wedi'i ffurfweddu, gall eich Ymgynghorydd Instructure ddarparu gwybodaeth ychwanegol ar ôl ei ffurfweddu.
- Ar ôl i'r SFTP gael ei ffurfweddu a'i gysoni â Chynhyrchu, bydd angen i'r cleient gysylltu â Chymorth i ddatrys problemau a/neu unrhyw newid ffurfweddiad i'r SFTP.
Sut ydw i'n dechrau?
Yn gyntaf, rhaid i'r cleient benderfynu pwy fydd yn cynnal y gweinydd SFTP. Mae dau opsiwn ar gyfer cynnal y gweinydd SFTP.
- Gall Instructure gynnal y gweinydd
- Mae'r cleient yn cynnal gweinydd SFTP
Y cleient sy'n gyfrifol am adeiladu'r ffeiliau CSV ar gyfer eu data wedi'u halinio â manylebau CSV Canvas a chyflwyno'r ffeiliau hynny i'r gweinydd SFTP. Yna bydd Instructure yn prosesu'r ffeiliau a osodwyd yn seiliedig ar swyddi wedi'u hamserlennu.
Bydd y Porth CSV yn cael ei gysylltu i ddechrau ag enghraifft Canvas Beta'r cleient ar gyfer profion cychwynnol. Ni fydd y cysylltiad yn cael ei newid i enghraifft Canvas Production y cleient nes bod y cleient yn rhoi cadarnhad ysgrifenedig i'w Ymgynghorydd Instructure i gwblhau'r profion.
Gweinydd a gynhelir gan Instructure
Os yw Instructure yn cynnal y gweinydd SFTP, bydd angen i'r cleient gynhyrchu pâr allweddi SSH. Anfonir yr allwedd gyhoeddus at eich Ymgynghorydd Instructure.
Ni ddylid rhannu'r allwedd breifat. Os yw'r allwedd breifat yn cael ei rhannu, bydd Instructure yn gofyn am gynhyrchu pâr allweddi newydd.
Wrth gynhyrchu'r pâr allweddi SSH, cofiwch y canlynol:
- Mae Instructure angen hyd bit o leiaf 2048 ar yr allwedd
- Fel arfer mae gan allweddi cyhoeddus un o'r estyniadau canlynol: .pub, .pem
- Bydd gan rai fformatau allweddi'r allwedd breifat gyda'r allwedd gyhoeddus, anfonwch yr allwedd gyhoeddus atom ni yn unig neu bydd angen ail-greu'r pâr allweddi.
Ar ôl i'r allwedd gyhoeddus gael ei rhannu gyda'r Ymgynghorydd Instructure a'i huwchlwytho i'r gweinydd SFTP, bydd y cleient yn cael y wybodaeth ganlynol:
- Gweinydd
- Porthladd
- Enw defnyddiwr
- Cyfeiriadur
- Amserlen cydamseru
Gweinydd a gynhelir gan gleient
Os yw'r cleient yn dewis cynnal y gweinydd SFTP, bydd angen darparu'r wybodaeth cysylltiad i Instructure.
Peidiwch ag anfon y wybodaeth hon mewn e-bost.
Bydd eich Ymgynghorydd Instructure yn rhoi dolen ddiogel i chi i uwchlwytho ffeil .txt gyda'r wybodaeth ganlynol:
- Gweinydd
- Porthladd
- Enw defnyddiwr
- Dilysu
- Ffolder/Cyfeiriadur
Yn ogystal â rhoi'r wybodaeth y gofynnwyd amdani i'ch Ymgynghorydd Instructure, efallai y bydd angen i'r cleient ychwanegu cyfeiriadau IP Instructure at restr ganiatadau. Bydd eich Ymgynghorydd Instructure yn rhoi'r wybodaeth y gofynnwyd amdani i chi. Efallai y bydd angen ffurfweddu/addasiadau ychwanegol ar weinydd y cleient os na all Instructure gysylltu â'r gweinydd SFTP o bell.