[{"data":1,"prerenderedAt":2056},["ShallowReactive",2],{"navigation":3,"\u002Fobserve\u002Fguides\u002Ffilesystem-connector":750,"\u002Fobserve\u002Fguides\u002Ffilesystem-connector-surround":2051},[4,80,134,364,428,530,567,646],{"title":5,"path":6,"stem":7,"children":8,"page":42},"Get Started","\u002Fget-started","01.get-started",[9,13,17,43,47],{"title":10,"path":11,"stem":12},"Welcome to UniteLabs","\u002Fget-started\u002Fwelcome","01.get-started\u002F00.welcome",{"title":14,"path":15,"stem":16},"How it works","\u002Fget-started\u002Fhow-it-works","01.get-started\u002F01.how-it-works",{"title":18,"path":19,"stem":20,"children":21,"page":42},"Use Cases","\u002Fget-started\u002Fuse-cases","01.get-started\u002F02.use-cases",[22,26,30,34,38],{"title":23,"path":24,"stem":25},"Instrument Control","\u002Fget-started\u002Fuse-cases\u002Flow-level-instrument-control","01.get-started\u002F02.use-cases\u002F10.low-level-instrument-control",{"title":27,"path":28,"stem":29},"Multi-device Control","\u002Fget-started\u002Fuse-cases\u002Fmulti-device-control","01.get-started\u002F02.use-cases\u002F20.multi-device-control",{"title":31,"path":32,"stem":33},"Workflow Orchestration","\u002Fget-started\u002Fuse-cases\u002Fworkflow-orchestration","01.get-started\u002F02.use-cases\u002F30.workflow-orchestration",{"title":35,"path":36,"stem":37},"Custom Apps and LIMS Integration","\u002Fget-started\u002Fuse-cases\u002Fcustom-apps-lims","01.get-started\u002F02.use-cases\u002F40.custom-apps-lims",{"title":39,"path":40,"stem":41},"Scale and Fleet Management","\u002Fget-started\u002Fuse-cases\u002Fscale-and-fleet","01.get-started\u002F02.use-cases\u002F50.scale-and-fleet",false,{"title":44,"path":45,"stem":46},"Lab as Code","\u002Fget-started\u002Fwhy-code","01.get-started\u002F03.why-code",{"title":48,"path":49,"stem":50,"children":51,"page":42},"Setup","\u002Fget-started\u002Fsetup","01.get-started\u002F20.setup",[52,56,60,64,68,72,76],{"title":53,"path":54,"stem":55},"GroundControl","\u002Fget-started\u002Fsetup\u002Fgroundcontrol","01.get-started\u002F20.setup\u002F10.groundcontrol",{"title":57,"path":58,"stem":59},"Network requirements","\u002Fget-started\u002Fsetup\u002Fnetwork-requirements","01.get-started\u002F20.setup\u002F20.network-requirements",{"title":61,"path":62,"stem":63},"Multi-device Networking","\u002Fget-started\u002Fsetup\u002Fmultiple-devices","01.get-started\u002F20.setup\u002F30.multiple-devices",{"title":65,"path":66,"stem":67},"Connect to Platform","\u002Fget-started\u002Fsetup\u002Fconnect-to-platform","01.get-started\u002F20.setup\u002F40.connect-to-platform",{"title":69,"path":70,"stem":71},"Headless install","\u002Fget-started\u002Fsetup\u002Fheadless-install","01.get-started\u002F20.setup\u002F50.headless-install",{"title":73,"path":74,"stem":75},"Raspberry Pi","\u002Fget-started\u002Fsetup\u002Fraspberry-pi","01.get-started\u002F20.setup\u002F55.raspberry-pi",{"title":77,"path":78,"stem":79},"Installation","\u002Fget-started\u002Fsetup\u002Fsdk-installation","01.get-started\u002F20.setup\u002F60.sdk-installation",{"title":81,"path":82,"stem":83,"children":84,"page":42},"Integrate","\u002Fintegrate","02.integrate",[85,89,93,118],{"title":86,"path":87,"stem":88},"What is a connector?","\u002Fintegrate\u002Fwhat-is-a-connector","02.integrate\u002F00.what-is-a-connector",{"title":90,"path":91,"stem":92},"Calling a Connector","\u002Fintegrate\u002Fcontrol-with-code","02.integrate\u002F05.control-with-code",{"title":94,"path":95,"stem":96,"children":97,"page":42},"Concepts","\u002Fintegrate\u002Fconcepts","02.integrate\u002F10.concepts",[98,102,106,110,114],{"title":99,"path":100,"stem":101},"Connector","\u002Fintegrate\u002Fconcepts\u002Fconnector","02.integrate\u002F10.concepts\u002F10.connector",{"title":103,"path":104,"stem":105},"Module","\u002Fintegrate\u002Fconcepts\u002Fmodule","02.integrate\u002F10.concepts\u002F20.module",{"title":107,"path":108,"stem":109},"Action","\u002Fintegrate\u002Fconcepts\u002Faction","02.integrate\u002F10.concepts\u002F30.action",{"title":111,"path":112,"stem":113},"Subscription","\u002Fintegrate\u002Fconcepts\u002Fsubscription","02.integrate\u002F10.concepts\u002F40.subscription",{"title":115,"path":116,"stem":117},"Device","\u002Fintegrate\u002Fconcepts\u002Fdevice","02.integrate\u002F10.concepts\u002F50.device",{"title":119,"path":120,"stem":121,"children":122,"page":42},"Use a connector","\u002Fintegrate\u002Fuse-a-connector","02.integrate\u002F30.use-a-connector",[123,126,130],{"title":53,"path":124,"stem":125},"\u002Fintegrate\u002Fuse-a-connector\u002Fgroundcontrol","02.integrate\u002F30.use-a-connector\u002F10.groundcontrol",{"title":127,"path":128,"stem":129},"Platform","\u002Fintegrate\u002Fuse-a-connector\u002Fplatform","02.integrate\u002F30.use-a-connector\u002F20.platform",{"title":131,"path":132,"stem":133},"UniteLabs SDK & REST API","\u002Fintegrate\u002Fuse-a-connector\u002Fpython","02.integrate\u002F30.use-a-connector\u002F30.python",{"title":135,"path":136,"stem":137,"children":138,"page":42},"Operate","\u002Foperate","03.operate",[139,142,146,186,259],{"title":135,"path":140,"stem":141},"\u002Foperate\u002Foverview","03.operate\u002F00.overview",{"title":143,"path":144,"stem":145},"Your First Protocol","\u002Foperate\u002Fyour-first-protocol","03.operate\u002F05.your-first-protocol",{"title":94,"path":147,"stem":148,"children":149,"page":42},"\u002Foperate\u002Fconcepts","03.operate\u002F10.concepts",[150,154,158,162,166,170,174,178,182],{"title":151,"path":152,"stem":153},"Liquid Handling","\u002Foperate\u002Fconcepts\u002Fliquid-handling","03.operate\u002F10.concepts\u002F10.liquid-handling",{"title":155,"path":156,"stem":157},"Modules","\u002Foperate\u002Fconcepts\u002Fmodules","03.operate\u002F10.concepts\u002F20.modules",{"title":159,"path":160,"stem":161},"Deck","\u002Foperate\u002Fconcepts\u002Fdeck","03.operate\u002F10.concepts\u002F30.deck",{"title":163,"path":164,"stem":165},"Labware","\u002Foperate\u002Fconcepts\u002Flabware","03.operate\u002F10.concepts\u002F40.labware",{"title":167,"path":168,"stem":169},"Liquids","\u002Foperate\u002Fconcepts\u002Fliquids","03.operate\u002F10.concepts\u002F50.liquids",{"title":171,"path":172,"stem":173},"Liquid Classes","\u002Foperate\u002Fconcepts\u002Fliquid-classes","03.operate\u002F10.concepts\u002F60.liquid-classes",{"title":175,"path":176,"stem":177},"Tips and Tip Tracking","\u002Foperate\u002Fconcepts\u002Ftips","03.operate\u002F10.concepts\u002F70.tips",{"title":179,"path":180,"stem":181},"Simulation","\u002Foperate\u002Fconcepts\u002Fsimulation","03.operate\u002F10.concepts\u002F80.simulation",{"title":183,"path":184,"stem":185},"Error Handling","\u002Foperate\u002Fconcepts\u002Ferror-handling","03.operate\u002F10.concepts\u002F90.error-handling",{"title":187,"path":188,"stem":189,"children":190,"page":42},"Guides","\u002Foperate\u002Fguides","03.operate\u002F20.guides",[191,220,232,256],{"title":163,"path":192,"stem":193,"children":194},"\u002Foperate\u002Fguides\u002Flabware","03.operate\u002F20.guides\u002F10.labware\u002Findex",[195,196,200,204,208,212,216],{"title":163,"path":192,"stem":193},{"title":197,"path":198,"stem":199},"Standard Labware","\u002Foperate\u002Fguides\u002Flabware\u002Fstandard-labware","03.operate\u002F20.guides\u002F10.labware\u002F05.standard-labware",{"title":201,"path":202,"stem":203},"Plates","\u002Foperate\u002Fguides\u002Flabware\u002Fplates","03.operate\u002F20.guides\u002F10.labware\u002F10.plates",{"title":205,"path":206,"stem":207},"Tips and Tip Racks","\u002Foperate\u002Fguides\u002Flabware\u002Ftips-and-racks","03.operate\u002F20.guides\u002F10.labware\u002F20.tips-and-racks",{"title":209,"path":210,"stem":211},"Tubes and Tube Racks","\u002Foperate\u002Fguides\u002Flabware\u002Ftubes-and-tube-racks","03.operate\u002F20.guides\u002F10.labware\u002F30.tubes-and-tube-racks",{"title":213,"path":214,"stem":215},"Troughs","\u002Foperate\u002Fguides\u002Flabware\u002Ftroughs","03.operate\u002F20.guides\u002F10.labware\u002F35.troughs",{"title":217,"path":218,"stem":219},"Carriers and Adapters","\u002Foperate\u002Fguides\u002Flabware\u002Fcarriers-and-adapters","03.operate\u002F20.guides\u002F10.labware\u002F40.carriers-and-adapters",{"title":159,"path":221,"stem":222,"children":223,"page":42},"\u002Foperate\u002Fguides\u002Fdeck","03.operate\u002F20.guides\u002F20.deck",[224,228],{"title":225,"path":226,"stem":227},"Building a Deck","\u002Foperate\u002Fguides\u002Fdeck\u002Fbuilding-a-deck","03.operate\u002F20.guides\u002F20.deck\u002F10.building-a-deck",{"title":229,"path":230,"stem":231},"Save\u002FLoad a Deck","\u002Foperate\u002Fguides\u002Fdeck\u002Fsave-load-deck","03.operate\u002F20.guides\u002F20.deck\u002F20.save-load-deck",{"title":233,"path":234,"stem":235,"children":236,"page":42},"Pipetting","\u002Foperate\u002Fguides\u002Fpipetting","03.operate\u002F20.guides\u002F30.pipetting",[237,241,245,249,252],{"title":238,"path":239,"stem":240},"Basic Pipetting","\u002Foperate\u002Fguides\u002Fpipetting\u002Fbasic-pipetting","03.operate\u002F20.guides\u002F30.pipetting\u002F10.basic-pipetting",{"title":242,"path":243,"stem":244},"Advanced Pipetting","\u002Foperate\u002Fguides\u002Fpipetting\u002Fadvanced-pipetting","03.operate\u002F20.guides\u002F30.pipetting\u002F20.advanced-pipetting",{"title":246,"path":247,"stem":248},"Tip Handling","\u002Foperate\u002Fguides\u002Fpipetting\u002Ftip-handling","03.operate\u002F20.guides\u002F30.pipetting\u002F30.tip-handling",{"title":171,"path":250,"stem":251},"\u002Foperate\u002Fguides\u002Fpipetting\u002Fliquid-classes","03.operate\u002F20.guides\u002F30.pipetting\u002F40.liquid-classes",{"title":253,"path":254,"stem":255},"Labware Transport","\u002Foperate\u002Fguides\u002Fpipetting\u002Flabware-transport","03.operate\u002F20.guides\u002F30.pipetting\u002F50.labware-transport",{"title":179,"path":257,"stem":258},"\u002Foperate\u002Fguides\u002Fsimulation","03.operate\u002F20.guides\u002F40.simulation",{"title":260,"path":261,"stem":262,"children":263,"page":42},"Liquid Handler Guides","\u002Foperate\u002Fdevices","03.operate\u002F30.devices",[264,305,330,347],{"title":265,"path":266,"stem":267,"children":268,"page":42},"Hamilton STAR","\u002Foperate\u002Fdevices\u002Fhamilton-star","03.operate\u002F30.devices\u002F10.hamilton-star",[269,273,277,281,285,289,293,297,301],{"title":270,"path":271,"stem":272},"Positioning & Movement","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fpositioning","03.operate\u002F30.devices\u002F10.hamilton-star\u002F10.positioning",{"title":274,"path":275,"stem":276},"Gripper Module","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fcore-gripper","03.operate\u002F30.devices\u002F10.hamilton-star\u002F20.core-gripper",{"title":278,"path":279,"stem":280},"iSWAP Module","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fiswap","03.operate\u002F30.devices\u002F10.hamilton-star\u002F30.iswap",{"title":282,"path":283,"stem":284},"Using TADM","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Ftadm","03.operate\u002F30.devices\u002F10.hamilton-star\u002F40.tadm",{"title":286,"path":287,"stem":288},"Autoload Module","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fautoload","03.operate\u002F30.devices\u002F10.hamilton-star\u002F50.autoload",{"title":290,"path":291,"stem":292},"Waste Block","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fwaste-block","03.operate\u002F30.devices\u002F10.hamilton-star\u002F60.waste-block",{"title":294,"path":295,"stem":296},"Complex Mixing","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fcomplex-mixing","03.operate\u002F30.devices\u002F10.hamilton-star\u002F66.complex-mixing",{"title":298,"path":299,"stem":300},"Teaching Gripper Paddle Positions","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fgripper-positions","03.operate\u002F30.devices\u002F10.hamilton-star\u002F70.gripper-positions",{"title":302,"path":303,"stem":304},"Training a Custom Deck Position With the iSWAP","\u002Foperate\u002Fdevices\u002Fhamilton-star\u002Fcustom-deck-position","03.operate\u002F30.devices\u002F10.hamilton-star\u002F75.custom-deck-position",{"title":306,"path":307,"stem":308,"children":309,"page":42},"Hamilton Vantage","\u002Foperate\u002Fdevices\u002Fhamilton-vantage","03.operate\u002F30.devices\u002F20.hamilton-vantage",[310,314,318,322,326],{"title":311,"path":312,"stem":313},"Waste Configuration","\u002Foperate\u002Fdevices\u002Fhamilton-vantage\u002Fwaste-configuration","03.operate\u002F30.devices\u002F20.hamilton-vantage\u002F05.waste-configuration",{"title":315,"path":316,"stem":317},"Covers and Lights","\u002Foperate\u002Fdevices\u002Fhamilton-vantage\u002Fcovers-and-lights","03.operate\u002F30.devices\u002F20.hamilton-vantage\u002F10.covers-and-lights",{"title":319,"path":320,"stem":321},"IDL Module","\u002Foperate\u002Fdevices\u002Fhamilton-vantage\u002Fidl","03.operate\u002F30.devices\u002F20.hamilton-vantage\u002F20.idl",{"title":323,"path":324,"stem":325},"IPG Module","\u002Foperate\u002Fdevices\u002Fhamilton-vantage\u002Fipg","03.operate\u002F30.devices\u002F20.hamilton-vantage\u002F30.ipg",{"title":327,"path":328,"stem":329},"XL Pipettes","\u002Foperate\u002Fdevices\u002Fhamilton-vantage\u002Fxl-channels","03.operate\u002F30.devices\u002F20.hamilton-vantage\u002F40.xl-channels",{"title":331,"path":332,"stem":333,"children":334,"page":42},"Agilent Bravo","\u002Foperate\u002Fdevices\u002Fagilent-bravo","03.operate\u002F30.devices\u002F30.agilent-bravo",[335,338,341,344],{"title":246,"path":336,"stem":337},"\u002Foperate\u002Fdevices\u002Fagilent-bravo\u002Ftip-handling","03.operate\u002F30.devices\u002F30.agilent-bravo\u002F10.tip-handling",{"title":238,"path":339,"stem":340},"\u002Foperate\u002Fdevices\u002Fagilent-bravo\u002Fbasic-pipetting","03.operate\u002F30.devices\u002F30.agilent-bravo\u002F20.basic-pipetting",{"title":171,"path":342,"stem":343},"\u002Foperate\u002Fdevices\u002Fagilent-bravo\u002Fliquid-classes","03.operate\u002F30.devices\u002F30.agilent-bravo\u002F25.liquid-classes",{"title":274,"path":345,"stem":346},"\u002Foperate\u002Fdevices\u002Fagilent-bravo\u002Fusing-the-gripper","03.operate\u002F30.devices\u002F30.agilent-bravo\u002F30.using-the-gripper",{"title":348,"path":349,"stem":350,"children":351,"page":42},"Tecan FluentControl","\u002Foperate\u002Fdevices\u002Ftecan-fluentcontrol","03.operate\u002F30.devices\u002F40.tecan-fluentcontrol",[352,356,360],{"title":353,"path":354,"stem":355},"Connect & Run a Method","\u002Foperate\u002Fdevices\u002Ftecan-fluentcontrol\u002Fconnect-and-run","03.operate\u002F30.devices\u002F40.tecan-fluentcontrol\u002F10.connect-and-run",{"title":357,"path":358,"stem":359},"Sending XML Commands","\u002Foperate\u002Fdevices\u002Ftecan-fluentcontrol\u002Fsending-xml-commands","03.operate\u002F30.devices\u002F40.tecan-fluentcontrol\u002F20.sending-xml-commands",{"title":361,"path":362,"stem":363},"Full Workflow Example","\u002Foperate\u002Fdevices\u002Ftecan-fluentcontrol\u002Ffull-workflow-example","03.operate\u002F30.devices\u002F40.tecan-fluentcontrol\u002F30.full-workflow-example",{"title":365,"path":366,"stem":367,"children":368,"page":42},"Device Guides","\u002Fdevice-guides","06.device-guides",[369,372,385,402,415],{"title":365,"path":370,"stem":371},"\u002Fdevice-guides\u002Foverview","06.device-guides\u002F00.overview",{"title":373,"path":374,"stem":375,"children":376,"page":42},"Incubation","\u002Fdevice-guides\u002Fincubation","06.device-guides\u002F20.incubation",[377,381],{"title":378,"path":379,"stem":380},"Inheco ODTC","\u002Fdevice-guides\u002Fincubation\u002Finheco-odtc","06.device-guides\u002F20.incubation\u002F10.inheco-odtc",{"title":382,"path":383,"stem":384},"Inheco SCILA","\u002Fdevice-guides\u002Fincubation\u002Finheco-scila","06.device-guides\u002F20.incubation\u002F20.inheco-scila",{"title":386,"path":387,"stem":388,"children":389,"page":42},"Heater-Shakers","\u002Fdevice-guides\u002Fheater-shakers","06.device-guides\u002F30.heater-shakers",[390,394,398],{"title":391,"path":392,"stem":393},"Inheco Thermoshake","\u002Fdevice-guides\u002Fheater-shakers\u002Finheco-thermoshake","06.device-guides\u002F30.heater-shakers\u002F10.inheco-thermoshake",{"title":395,"path":396,"stem":397},"QInstruments Bioshake","\u002Fdevice-guides\u002Fheater-shakers\u002Fqinstruments-bioshake","06.device-guides\u002F30.heater-shakers\u002F20.qinstruments-bioshake",{"title":399,"path":400,"stem":401},"QInstruments ColdPlate","\u002Fdevice-guides\u002Fheater-shakers\u002Fqinstruments-coldplate","06.device-guides\u002F30.heater-shakers\u002F30.qinstruments-coldplate",{"title":403,"path":404,"stem":405,"children":406,"page":42},"Readers","\u002Fdevice-guides\u002Freaders","06.device-guides\u002F40.readers",[407,411],{"title":408,"path":409,"stem":410},"Biotek Gen5","\u002Fdevice-guides\u002Freaders\u002Fbiotek-gen5","06.device-guides\u002F40.readers\u002F10.biotek-gen5",{"title":412,"path":413,"stem":414},"Biotek Synergy H1","\u002Fdevice-guides\u002Freaders\u002Fbiotek-synergy-h1","06.device-guides\u002F40.readers\u002F20.biotek-synergy-H1",{"title":416,"path":417,"stem":418,"children":419,"page":42},"Tilt & Turn","\u002Fdevice-guides\u002Ftilt-and-turn","06.device-guides\u002F50.tilt-and-turn",[420,424],{"title":421,"path":422,"stem":423},"TurnStation","\u002Fdevice-guides\u002Ftilt-and-turn\u002Fqinstruments-turnstation","06.device-guides\u002F50.tilt-and-turn\u002F10.qinstruments-turnstation",{"title":425,"path":426,"stem":427},"TiltStation","\u002Fdevice-guides\u002Ftilt-and-turn\u002Fqinstruments-tiltstation","06.device-guides\u002F50.tilt-and-turn\u002F20.qinstruments-tiltstation",{"title":429,"path":430,"stem":431,"children":432,"page":42},"Automate","\u002Fautomate","07.automate",[433,437,441,445,494],{"title":434,"path":435,"stem":436},"What is a workflow?","\u002Fautomate\u002Fwhat-is-a-workflow","07.automate\u002F00.what-is-a-workflow",{"title":438,"path":439,"stem":440},"Workflow template","\u002Fautomate\u002Fworkflow-template","07.automate\u002F05.workflow-template",{"title":442,"path":443,"stem":444},"Your First Workflow","\u002Fautomate\u002Fyour-first-workflow","07.automate\u002F08.your-first-workflow",{"title":94,"pages":446,"path":456,"stem":457,"children":458,"page":42},[447,448,449,450,451,452,453,454,455],"workflow","phase","step","runs","input","artifacts","logs","human-in-the-loop","error-handling","\u002Fautomate\u002Fconcepts","07.automate\u002F10.concepts",[459,463,467,471,475,479,483,487,491],{"title":460,"path":461,"stem":462},"Workflow","\u002Fautomate\u002Fconcepts\u002Fworkflow","07.automate\u002F10.concepts\u002F10.workflow",{"title":464,"path":465,"stem":466},"Phase","\u002Fautomate\u002Fconcepts\u002Fphase","07.automate\u002F10.concepts\u002F20.phase",{"title":468,"path":469,"stem":470},"Step","\u002Fautomate\u002Fconcepts\u002Fstep","07.automate\u002F10.concepts\u002F30.step",{"title":472,"path":473,"stem":474},"Runs","\u002Fautomate\u002Fconcepts\u002Fruns","07.automate\u002F10.concepts\u002F40.runs",{"title":476,"path":477,"stem":478},"Input","\u002Fautomate\u002Fconcepts\u002Finput","07.automate\u002F10.concepts\u002F50.input",{"title":480,"path":481,"stem":482},"Artifacts","\u002Fautomate\u002Fconcepts\u002Fartifacts","07.automate\u002F10.concepts\u002F60.artifacts",{"title":484,"path":485,"stem":486},"Logs","\u002Fautomate\u002Fconcepts\u002Flogs","07.automate\u002F10.concepts\u002F70.logs",{"title":488,"path":489,"stem":490},"Human in the Loop","\u002Fautomate\u002Fconcepts\u002Fhuman-in-the-loop","07.automate\u002F10.concepts\u002F80.human-in-the-loop",{"title":183,"path":492,"stem":493},"\u002Fautomate\u002Fconcepts\u002Ferror-handling","07.automate\u002F10.concepts\u002F90.error-handling",{"title":187,"path":495,"stem":496,"children":497,"page":42},"\u002Fautomate\u002Fguides","07.automate\u002F25.guides",[498,502,506,510,514,518,522,526],{"title":499,"path":500,"stem":501},"Deploy a workflow","\u002Fautomate\u002Fguides\u002Fdeploy-a-workflow","07.automate\u002F25.guides\u002F30.deploy-a-workflow",{"title":503,"path":504,"stem":505},"Run a workflow","\u002Fautomate\u002Fguides\u002Frun-a-workflow","07.automate\u002F25.guides\u002F35.run-a-workflow",{"title":507,"path":508,"stem":509},"CI\u002FCD for workflows","\u002Fautomate\u002Fguides\u002Fcicd-for-workflows","07.automate\u002F25.guides\u002F40.cicd-for-workflows",{"title":511,"path":512,"stem":513},"HITL basics","\u002Fautomate\u002Fguides\u002Fbasic-hitl","07.automate\u002F25.guides\u002F50.basic-hitl",{"title":515,"path":516,"stem":517},"Typed operator inputs","\u002Fautomate\u002Fguides\u002Ftyped-operator-inputs","07.automate\u002F25.guides\u002F55.typed-operator-inputs",{"title":519,"path":520,"stem":521},"Error recovery","\u002Fautomate\u002Fguides\u002Fbasic-error-handling","07.automate\u002F25.guides\u002F60.basic-error-handling",{"title":523,"path":524,"stem":525},"Advanced error handling","\u002Fautomate\u002Fguides\u002Fadvanced-error-handling","07.automate\u002F25.guides\u002F70.advanced-error-handling",{"title":527,"path":528,"stem":529},"Workflows REST API","\u002Fautomate\u002Fguides\u002Fworkflows-api","07.automate\u002F25.guides\u002F80.workflows-api",{"title":531,"path":532,"stem":533,"children":534,"page":42},"Observe","\u002Fobserve","08.observe",[535,539,555],{"title":536,"path":537,"stem":538},"Overview","\u002Fobserve\u002Foverview","08.observe\u002F10.overview",{"title":94,"path":540,"stem":541,"children":542,"page":42},"\u002Fobserve\u002Fconcepts","08.observe\u002F20.concepts",[543,547,551],{"title":544,"path":545,"stem":546},"Object Storage","\u002Fobserve\u002Fconcepts\u002Fstorage","08.observe\u002F20.concepts\u002F10.storage",{"title":548,"path":549,"stem":550},"Secrets","\u002Fobserve\u002Fconcepts\u002Fsecrets","08.observe\u002F20.concepts\u002F20.secrets",{"title":552,"path":553,"stem":554},"Data sources","\u002Fobserve\u002Fconcepts\u002Fdata-sources","08.observe\u002F20.concepts\u002F30.data-sources",{"title":187,"path":556,"stem":557,"children":558,"page":42},"\u002Fobserve\u002Fguides","08.observe\u002F30.guides",[559,563],{"title":560,"path":561,"stem":562},"File System Connector","\u002Fobserve\u002Fguides\u002Ffilesystem-connector","08.observe\u002F30.guides\u002F10.filesystem-connector",{"title":564,"path":565,"stem":566},"Building an ETL","\u002Fobserve\u002Fguides\u002Fbuilding-an-etl","08.observe\u002F30.guides\u002F20.building-an-etl",{"title":568,"path":569,"stem":570,"children":571,"page":42},"Technical Reference","\u002Ftechnical-reference","10.technical-reference",[572,576,580,592,603,614,624,635],{"title":573,"path":574,"stem":575},"Introduction","\u002Ftechnical-reference\u002Fplatform-blueprint","10.technical-reference\u002F00.platform-blueprint",{"title":577,"path":578,"stem":579},"REST API","\u002Ftechnical-reference\u002Frest-api","10.technical-reference\u002F01.rest-api",{"title":53,"path":581,"stem":582,"children":583,"page":42},"\u002Ftechnical-reference\u002Fgroundcontrol","10.technical-reference\u002F10.groundcontrol",[584,588],{"title":585,"path":586,"stem":587},"Install & Setup","\u002Ftechnical-reference\u002Fgroundcontrol\u002Finstall","10.technical-reference\u002F10.groundcontrol\u002F10.install",{"title":589,"path":590,"stem":591},"Changelog","\u002Ftechnical-reference\u002Fgroundcontrol\u002Fchangelog","10.technical-reference\u002F10.groundcontrol\u002F20.changelog",{"title":593,"path":594,"stem":595,"children":596,"page":42},"UniteLabs SDK","\u002Ftechnical-reference\u002Fpython-sdk","10.technical-reference\u002F20.python-sdk",[597,600],{"title":585,"path":598,"stem":599},"\u002Ftechnical-reference\u002Fpython-sdk\u002Finstall","10.technical-reference\u002F20.python-sdk\u002F10.install",{"title":589,"path":601,"stem":602},"\u002Ftechnical-reference\u002Fpython-sdk\u002Fchangelog","10.technical-reference\u002F20.python-sdk\u002F20.changelog",{"title":604,"path":605,"stem":606,"children":607,"page":42},"Liquid Handling SDK","\u002Ftechnical-reference\u002Fpython-liquid-handling-sdk","10.technical-reference\u002F30.python-liquid-handling-sdk",[608,611],{"title":585,"path":609,"stem":610},"\u002Ftechnical-reference\u002Fpython-liquid-handling-sdk\u002Finstall","10.technical-reference\u002F30.python-liquid-handling-sdk\u002F10.install",{"title":589,"path":612,"stem":613},"\u002Ftechnical-reference\u002Fpython-liquid-handling-sdk\u002Fchangelog","10.technical-reference\u002F30.python-liquid-handling-sdk\u002F20.changelog",{"title":163,"path":615,"stem":616,"children":617,"page":42},"\u002Ftechnical-reference\u002Flabware","10.technical-reference\u002F40.labware",[618,621],{"title":585,"path":619,"stem":620},"\u002Ftechnical-reference\u002Flabware\u002Finstall","10.technical-reference\u002F40.labware\u002F10.install",{"title":589,"path":622,"stem":623},"\u002Ftechnical-reference\u002Flabware\u002Fchangelog","10.technical-reference\u002F40.labware\u002F20.changelog",{"title":625,"path":626,"stem":627,"children":628,"page":42},"Python Omnibus","\u002Ftechnical-reference\u002Fpython-omnibus","10.technical-reference\u002F50.python-omnibus",[629,632],{"title":585,"path":630,"stem":631},"\u002Ftechnical-reference\u002Fpython-omnibus\u002Finstall","10.technical-reference\u002F50.python-omnibus\u002F10.install",{"title":589,"path":633,"stem":634},"\u002Ftechnical-reference\u002Fpython-omnibus\u002Fchangelog","10.technical-reference\u002F50.python-omnibus\u002F20.changelog",{"title":636,"path":637,"stem":638,"children":639,"page":42},"Python CDK","\u002Ftechnical-reference\u002Fpython-cdk","10.technical-reference\u002F60.python-cdk",[640,643],{"title":585,"path":641,"stem":642},"\u002Ftechnical-reference\u002Fpython-cdk\u002Finstall","10.technical-reference\u002F60.python-cdk\u002F10.install",{"title":589,"path":644,"stem":645},"\u002Ftechnical-reference\u002Fpython-cdk\u002Fchangelog","10.technical-reference\u002F60.python-cdk\u002F20.changelog",{"title":647,"path":648,"stem":649,"children":650},"Connector Development (CDK)","\u002Fconnector-development","20.connector-development",[651,653,672,705,713,744],{"title":647,"path":648,"stem":652},"20.connector-development\u002Findex",{"title":654,"path":655,"stem":656,"children":657,"page":42},"Getting Started","\u002Fconnector-development\u002Fgetting-started","20.connector-development\u002F10.getting-started",[658,661,665,668],{"title":536,"path":659,"stem":660},"\u002Fconnector-development\u002Fgetting-started\u002Foverview","20.connector-development\u002F10.getting-started\u002F10.overview",{"title":662,"path":663,"stem":664},"What's new","\u002Fconnector-development\u002Fgetting-started\u002Fwhats-new","20.connector-development\u002F10.getting-started\u002F20.whats-new",{"title":77,"path":666,"stem":667},"\u002Fconnector-development\u002Fgetting-started\u002Finstallation","20.connector-development\u002F10.getting-started\u002F30.installation",{"title":669,"path":670,"stem":671},"Contributing","\u002Fconnector-development\u002Fgetting-started\u002Fcontributing","20.connector-development\u002F10.getting-started\u002F40.contributing",{"title":673,"path":674,"stem":675,"children":676,"page":42},"Tutorial","\u002Fconnector-development\u002Ftutorial","20.connector-development\u002F20.tutorial",[677,681,685,689,693,697,701],{"title":678,"path":679,"stem":680},"Walkthrough","\u002Fconnector-development\u002Ftutorial\u002Fwalkthrough","20.connector-development\u002F20.tutorial\u002F00.walkthrough",{"title":682,"path":683,"stem":684},"SiLA Endpoints","\u002Fconnector-development\u002Ftutorial\u002Fsila-endpoints","20.connector-development\u002F20.tutorial\u002F10.sila-endpoints",{"title":686,"path":687,"stem":688},"Data Endpoints","\u002Fconnector-development\u002Ftutorial\u002Fdata-endpoints","20.connector-development\u002F20.tutorial\u002F20.data-endpoints",{"title":690,"path":691,"stem":692},"Controls","\u002Fconnector-development\u002Ftutorial\u002Fcontrols","20.connector-development\u002F20.tutorial\u002F30.controls",{"title":694,"path":695,"stem":696},"SiLA Data Types","\u002Fconnector-development\u002Ftutorial\u002Fdata-types","20.connector-development\u002F20.tutorial\u002F40.data-types",{"title":698,"path":699,"stem":700},"Feature","\u002Fconnector-development\u002Ftutorial\u002Fconnector-structure","20.connector-development\u002F20.tutorial\u002F70.connector-structure",{"title":702,"path":703,"stem":704},"Hardware Communication","\u002Fconnector-development\u002Ftutorial\u002Fhardware-communication","20.connector-development\u002F20.tutorial\u002F90.hardware-communication",{"title":94,"path":706,"stem":707,"children":708,"page":42},"\u002Fconnector-development\u002Fconcepts","20.connector-development\u002F30.concepts",[709],{"title":710,"path":711,"stem":712},"SiLA","\u002Fconnector-development\u002Fconcepts\u002Fsila","20.connector-development\u002F30.concepts\u002Fsila",{"title":187,"path":714,"stem":715,"children":716,"page":42},"\u002Fconnector-development\u002Fguides","20.connector-development\u002F40.guides",[717,721,725,729,733,736,740],{"title":718,"path":719,"stem":720},"Configuration","\u002Fconnector-development\u002Fguides\u002Fconfiguration","20.connector-development\u002F40.guides\u002F20.configuration",{"title":722,"path":723,"stem":724},"Deployment","\u002Fconnector-development\u002Fguides\u002Fdeployment","20.connector-development\u002F40.guides\u002F30.deployment",{"title":726,"path":727,"stem":728},"Security","\u002Fconnector-development\u002Fguides\u002Fsecurity","20.connector-development\u002F40.guides\u002F40.security",{"title":730,"path":731,"stem":732},"Subscriptions","\u002Fconnector-development\u002Fguides\u002Fsubscriptions","20.connector-development\u002F40.guides\u002F45.subscriptions",{"title":183,"path":734,"stem":735},"\u002Fconnector-development\u002Fguides\u002Ferror-handling","20.connector-development\u002F40.guides\u002F50.error-handling",{"title":737,"path":738,"stem":739},"Serial Troubleshooting","\u002Fconnector-development\u002Fguides\u002Fserial-troubleshooting","20.connector-development\u002F40.guides\u002F70.serial-troubleshooting",{"title":741,"path":742,"stem":743},"Testing","\u002Fconnector-development\u002Fguides\u002Ftesting","20.connector-development\u002F40.guides\u002F80.testing",{"title":745,"path":746,"stem":747,"children":748},"References","\u002Fconnector-development\u002Freference","20.connector-development\u002F50.reference\u002Findex",[749],{"title":745,"path":746,"stem":747},{"id":751,"title":560,"body":752,"description":2045,"extension":2046,"links":2047,"meta":2048,"navigation":831,"path":561,"seo":2049,"stem":562,"__hash__":2050},"docs\u002F08.observe\u002F30.guides\u002F10.filesystem-connector.md",{"type":753,"value":754,"toc":2035},"minimark",[755,759,765,786,791,892,902,906,913,962,966,1061,1065,1068,1237,1241,1247,1374,1386,1390,1393,1530,1542,1546,1549,2014,2018,2031],[756,757,758],"p",{},"File System Connectors give workflows programmatic access to directories on lab instruments. Using the UniteLabs SDK, you can list files, stream real-time change notifications, retrieve file metadata, and upload files to Object Storage — all without touching the instrument OS directly.",[756,760,761],{},[762,763,764],"strong",{},"Prerequisites",[766,767,768,776,779],"ul",{},[769,770,771,772,775],"li",{},"A running File System Connector visible in the ",[762,773,774],{},"Connectors"," view of the platform.",[769,777,778],{},"A UniteLabs account with SDK access.",[769,780,781,785],{},[782,783,784],"code",{},"unitelabs-sdk"," installed in your Python environment.",[787,788,790],"h2",{"id":789},"connect-to-a-connector","Connect to a connector",[792,793,798],"pre",{"className":794,"code":795,"language":796,"meta":797,"style":797},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","from unitelabs.sdk import AsyncApiClient\n\nasync with AsyncApiClient() as client:\n    device = await client.get_service_by_name(\"File System (LabChip)\")\n","python","",[782,799,800,826,833,858],{"__ignoreMap":797},[801,802,805,809,813,817,820,823],"span",{"class":803,"line":804},"line",1,[801,806,808],{"class":807},"s7zQu","from",[801,810,812],{"class":811},"sTEyZ"," unitelabs",[801,814,816],{"class":815},"sMK4o",".",[801,818,819],{"class":811},"sdk ",[801,821,822],{"class":807},"import",[801,824,825],{"class":811}," AsyncApiClient\n",[801,827,829],{"class":803,"line":828},2,[801,830,832],{"emptyLinePlaceholder":831},true,"\n",[801,834,836,839,842,846,849,852,855],{"class":803,"line":835},3,[801,837,838],{"class":807},"async",[801,840,841],{"class":807}," with",[801,843,845],{"class":844},"s2Zo4"," AsyncApiClient",[801,847,848],{"class":815},"()",[801,850,851],{"class":807}," as",[801,853,854],{"class":811}," client",[801,856,857],{"class":815},":\n",[801,859,861,864,867,870,872,874,877,880,883,887,889],{"class":803,"line":860},4,[801,862,863],{"class":811},"    device ",[801,865,866],{"class":815},"=",[801,868,869],{"class":807}," await",[801,871,854],{"class":811},[801,873,816],{"class":815},[801,875,876],{"class":844},"get_service_by_name",[801,878,879],{"class":815},"(",[801,881,882],{"class":815},"\"",[801,884,886],{"class":885},"sfazB","File System (LabChip)",[801,888,882],{"class":815},[801,890,891],{"class":815},")\n",[893,894,896],"callout",{"icon":895},"i-heroicons-light-bulb",[756,897,898,899,901],{},"The connector name must match exactly what appears in the ",[762,900,774],{}," view. Names are case-sensitive.",[787,903,905],{"id":904},"list-available-folders","List available folders",[756,907,908,909,912],{},"Connectors expose only pre-approved directories to prevent arbitrary filesystem access. Use ",[782,910,911],{},"get_folder_whitelist()"," to retrieve the allowed set:",[792,914,916],{"className":794,"code":915,"language":796,"meta":797,"style":797},"whitelist = await device.folder_service.get_folder_whitelist()\nprint(whitelist)\n# ['\u002Fdata\u002Flabchip\u002Fresults', '\u002Fdata\u002Flabchip\u002Farchive']\n",[782,917,918,944,956],{"__ignoreMap":797},[801,919,920,923,925,927,930,932,936,938,941],{"class":803,"line":804},[801,921,922],{"class":811},"whitelist ",[801,924,866],{"class":815},[801,926,869],{"class":807},[801,928,929],{"class":811}," device",[801,931,816],{"class":815},[801,933,935],{"class":934},"swJcz","folder_service",[801,937,816],{"class":815},[801,939,940],{"class":844},"get_folder_whitelist",[801,942,943],{"class":815},"()\n",[801,945,946,949,951,954],{"class":803,"line":828},[801,947,948],{"class":844},"print",[801,950,879],{"class":815},[801,952,953],{"class":844},"whitelist",[801,955,891],{"class":815},[801,957,958],{"class":803,"line":835},[801,959,961],{"class":960},"sHwdD","# ['\u002Fdata\u002Flabchip\u002Fresults', '\u002Fdata\u002Flabchip\u002Farchive']\n",[787,963,965],{"id":964},"list-files-in-a-folder","List files in a folder",[792,967,969],{"className":794,"code":968,"language":796,"meta":797,"style":797},"files = await device.folder_service.get_folder_contents(\n    path=\"\u002Fdata\u002Flabchip\u002Fresults\"\n)\nfor f in files:\n    print(f)\n# \u002Fdata\u002Flabchip\u002Fresults\u002Frun_001_PeakTable.csv\n# \u002Fdata\u002Flabchip\u002Fresults\u002Frun_001_SizeTable.csv\n# \u002Fdata\u002Flabchip\u002Fresults\u002Frun_001_WellTable.csv\n",[782,970,971,994,1010,1014,1030,1043,1049,1055],{"__ignoreMap":797},[801,972,973,976,978,980,982,984,986,988,991],{"class":803,"line":804},[801,974,975],{"class":811},"files ",[801,977,866],{"class":815},[801,979,869],{"class":807},[801,981,929],{"class":811},[801,983,816],{"class":815},[801,985,935],{"class":934},[801,987,816],{"class":815},[801,989,990],{"class":844},"get_folder_contents",[801,992,993],{"class":815},"(\n",[801,995,996,1000,1002,1004,1007],{"class":803,"line":828},[801,997,999],{"class":998},"sHdIc","    path",[801,1001,866],{"class":815},[801,1003,882],{"class":815},[801,1005,1006],{"class":885},"\u002Fdata\u002Flabchip\u002Fresults",[801,1008,1009],{"class":815},"\"\n",[801,1011,1012],{"class":803,"line":835},[801,1013,891],{"class":815},[801,1015,1016,1019,1022,1025,1028],{"class":803,"line":860},[801,1017,1018],{"class":807},"for",[801,1020,1021],{"class":811}," f ",[801,1023,1024],{"class":807},"in",[801,1026,1027],{"class":811}," files",[801,1029,857],{"class":815},[801,1031,1033,1036,1038,1041],{"class":803,"line":1032},5,[801,1034,1035],{"class":844},"    print",[801,1037,879],{"class":815},[801,1039,1040],{"class":844},"f",[801,1042,891],{"class":815},[801,1044,1046],{"class":803,"line":1045},6,[801,1047,1048],{"class":960},"# \u002Fdata\u002Flabchip\u002Fresults\u002Frun_001_PeakTable.csv\n",[801,1050,1052],{"class":803,"line":1051},7,[801,1053,1054],{"class":960},"# \u002Fdata\u002Flabchip\u002Fresults\u002Frun_001_SizeTable.csv\n",[801,1056,1058],{"class":803,"line":1057},8,[801,1059,1060],{"class":960},"# \u002Fdata\u002Flabchip\u002Fresults\u002Frun_001_WellTable.csv\n",[787,1062,1064],{"id":1063},"get-file-metadata","Get file metadata",[756,1066,1067],{},"Retrieve size, owner, and timestamps before deciding whether to process a file:",[792,1069,1071],{"className":794,"code":1070,"language":796,"meta":797,"style":797},"meta = await device.file_service.get_file_metadata(\n    path=\"\u002Fdata\u002Flabchip\u002Fresults\u002Frun_001_PeakTable.csv\"\n)\n\nprint(meta[\"Metadata\"][\"Size\"][\"value\"])          # file size in bytes\nprint(meta[\"Metadata\"][\"LastModified\"][\"value\"])  # ISO timestamp\nprint(meta[\"Metadata\"][\"Owner\"][\"value\"])          # OS user (\"unknown\" on Windows)\n",[782,1072,1073,1096,1109,1113,1117,1161,1199],{"__ignoreMap":797},[801,1074,1075,1078,1080,1082,1084,1086,1089,1091,1094],{"class":803,"line":804},[801,1076,1077],{"class":811},"meta ",[801,1079,866],{"class":815},[801,1081,869],{"class":807},[801,1083,929],{"class":811},[801,1085,816],{"class":815},[801,1087,1088],{"class":934},"file_service",[801,1090,816],{"class":815},[801,1092,1093],{"class":844},"get_file_metadata",[801,1095,993],{"class":815},[801,1097,1098,1100,1102,1104,1107],{"class":803,"line":828},[801,1099,999],{"class":998},[801,1101,866],{"class":815},[801,1103,882],{"class":815},[801,1105,1106],{"class":885},"\u002Fdata\u002Flabchip\u002Fresults\u002Frun_001_PeakTable.csv",[801,1108,1009],{"class":815},[801,1110,1111],{"class":803,"line":835},[801,1112,891],{"class":815},[801,1114,1115],{"class":803,"line":860},[801,1116,832],{"emptyLinePlaceholder":831},[801,1118,1119,1121,1123,1126,1129,1131,1134,1136,1139,1141,1144,1146,1148,1150,1153,1155,1158],{"class":803,"line":1032},[801,1120,948],{"class":844},[801,1122,879],{"class":815},[801,1124,1125],{"class":844},"meta",[801,1127,1128],{"class":815},"[",[801,1130,882],{"class":815},[801,1132,1133],{"class":885},"Metadata",[801,1135,882],{"class":815},[801,1137,1138],{"class":815},"][",[801,1140,882],{"class":815},[801,1142,1143],{"class":885},"Size",[801,1145,882],{"class":815},[801,1147,1138],{"class":815},[801,1149,882],{"class":815},[801,1151,1152],{"class":885},"value",[801,1154,882],{"class":815},[801,1156,1157],{"class":815},"])",[801,1159,1160],{"class":960},"          # file size in bytes\n",[801,1162,1163,1165,1167,1169,1171,1173,1175,1177,1179,1181,1184,1186,1188,1190,1192,1194,1196],{"class":803,"line":1045},[801,1164,948],{"class":844},[801,1166,879],{"class":815},[801,1168,1125],{"class":844},[801,1170,1128],{"class":815},[801,1172,882],{"class":815},[801,1174,1133],{"class":885},[801,1176,882],{"class":815},[801,1178,1138],{"class":815},[801,1180,882],{"class":815},[801,1182,1183],{"class":885},"LastModified",[801,1185,882],{"class":815},[801,1187,1138],{"class":815},[801,1189,882],{"class":815},[801,1191,1152],{"class":885},[801,1193,882],{"class":815},[801,1195,1157],{"class":815},[801,1197,1198],{"class":960},"  # ISO timestamp\n",[801,1200,1201,1203,1205,1207,1209,1211,1213,1215,1217,1219,1222,1224,1226,1228,1230,1232,1234],{"class":803,"line":1051},[801,1202,948],{"class":844},[801,1204,879],{"class":815},[801,1206,1125],{"class":844},[801,1208,1128],{"class":815},[801,1210,882],{"class":815},[801,1212,1133],{"class":885},[801,1214,882],{"class":815},[801,1216,1138],{"class":815},[801,1218,882],{"class":815},[801,1220,1221],{"class":885},"Owner",[801,1223,882],{"class":815},[801,1225,1138],{"class":815},[801,1227,882],{"class":815},[801,1229,1152],{"class":885},[801,1231,882],{"class":815},[801,1233,1157],{"class":815},[801,1235,1236],{"class":960},"          # OS user (\"unknown\" on Windows)\n",[787,1238,1240],{"id":1239},"watch-for-new-files","Watch for new files",[756,1242,1243,1246],{},[782,1244,1245],{},"subscribe_changes()"," is the key real-time capability. It returns an async context manager that yields the path of each new or modified file as it appears:",[792,1248,1250],{"className":794,"code":1249,"language":796,"meta":797,"style":797},"async with AsyncApiClient() as client:\n    device = await client.get_service_by_name(\"File System (LabChip)\")\n\n    async with await device.folder_service.subscribe_changes() as subscription:\n        async for changed_path in subscription:\n            print(f\"New or modified file: {changed_path}\")\n            # trigger processing here\n",[782,1251,1252,1268,1292,1296,1325,1342,1369],{"__ignoreMap":797},[801,1253,1254,1256,1258,1260,1262,1264,1266],{"class":803,"line":804},[801,1255,838],{"class":807},[801,1257,841],{"class":807},[801,1259,845],{"class":844},[801,1261,848],{"class":815},[801,1263,851],{"class":807},[801,1265,854],{"class":811},[801,1267,857],{"class":815},[801,1269,1270,1272,1274,1276,1278,1280,1282,1284,1286,1288,1290],{"class":803,"line":828},[801,1271,863],{"class":811},[801,1273,866],{"class":815},[801,1275,869],{"class":807},[801,1277,854],{"class":811},[801,1279,816],{"class":815},[801,1281,876],{"class":844},[801,1283,879],{"class":815},[801,1285,882],{"class":815},[801,1287,886],{"class":885},[801,1289,882],{"class":815},[801,1291,891],{"class":815},[801,1293,1294],{"class":803,"line":835},[801,1295,832],{"emptyLinePlaceholder":831},[801,1297,1298,1301,1303,1305,1307,1309,1311,1313,1316,1318,1320,1323],{"class":803,"line":860},[801,1299,1300],{"class":807},"    async",[801,1302,841],{"class":807},[801,1304,869],{"class":807},[801,1306,929],{"class":811},[801,1308,816],{"class":815},[801,1310,935],{"class":934},[801,1312,816],{"class":815},[801,1314,1315],{"class":844},"subscribe_changes",[801,1317,848],{"class":815},[801,1319,851],{"class":807},[801,1321,1322],{"class":811}," subscription",[801,1324,857],{"class":815},[801,1326,1327,1330,1333,1336,1338,1340],{"class":803,"line":1032},[801,1328,1329],{"class":807},"        async",[801,1331,1332],{"class":807}," for",[801,1334,1335],{"class":811}," changed_path ",[801,1337,1024],{"class":807},[801,1339,1322],{"class":811},[801,1341,857],{"class":815},[801,1343,1344,1347,1349,1352,1355,1359,1362,1365,1367],{"class":803,"line":1045},[801,1345,1346],{"class":844},"            print",[801,1348,879],{"class":815},[801,1350,1040],{"class":1351},"spNyl",[801,1353,1354],{"class":885},"\"New or modified file: ",[801,1356,1358],{"class":1357},"sbssI","{",[801,1360,1361],{"class":844},"changed_path",[801,1363,1364],{"class":1357},"}",[801,1366,882],{"class":885},[801,1368,891],{"class":815},[801,1370,1371],{"class":803,"line":1051},[801,1372,1373],{"class":960},"            # trigger processing here\n",[893,1375,1377],{"icon":1376},"i-heroicons-exclamation-triangle",[756,1378,1379,1381,1382,1385],{},[782,1380,1245],{}," is a long-running async generator. Run it inside a Prefect ",[782,1383,1384],{},"@task"," or a dedicated async loop — do not call it in a blocking synchronous context.",[787,1387,1389],{"id":1388},"upload-a-file-to-object-storage","Upload a file to Object Storage",[756,1391,1392],{},"Transfer a file from the instrument directory directly to S3 — no local intermediate copy:",[792,1394,1396],{"className":794,"code":1395,"language":796,"meta":797,"style":797},"s3_url = (\n    f\"s3s:\u002F\u002F{access_key}:{secret_key}\"\n    f\"@{host}:{port}\u002F{bucket}\u002Fdata\u002Finstruments\u002Flabchip\u002Frun_001_PeakTable.csv\"\n)\n\nawait device.s3_service.upload_file(\n    path=\"\u002Fdata\u002Flabchip\u002Fresults\u002Frun_001_PeakTable.csv\",\n    s3_url=s3_url,\n)\n",[782,1397,1398,1408,1435,1471,1475,1479,1498,1513,1525],{"__ignoreMap":797},[801,1399,1400,1403,1405],{"class":803,"line":804},[801,1401,1402],{"class":811},"s3_url ",[801,1404,866],{"class":815},[801,1406,1407],{"class":815}," (\n",[801,1409,1410,1413,1416,1418,1421,1423,1426,1428,1431,1433],{"class":803,"line":828},[801,1411,1412],{"class":1351},"    f",[801,1414,1415],{"class":885},"\"s3s:\u002F\u002F",[801,1417,1358],{"class":1357},[801,1419,1420],{"class":811},"access_key",[801,1422,1364],{"class":1357},[801,1424,1425],{"class":885},":",[801,1427,1358],{"class":1357},[801,1429,1430],{"class":811},"secret_key",[801,1432,1364],{"class":1357},[801,1434,1009],{"class":885},[801,1436,1437,1439,1442,1444,1447,1449,1451,1453,1456,1458,1461,1463,1466,1468],{"class":803,"line":835},[801,1438,1412],{"class":1351},[801,1440,1441],{"class":885},"\"@",[801,1443,1358],{"class":1357},[801,1445,1446],{"class":811},"host",[801,1448,1364],{"class":1357},[801,1450,1425],{"class":885},[801,1452,1358],{"class":1357},[801,1454,1455],{"class":811},"port",[801,1457,1364],{"class":1357},[801,1459,1460],{"class":885},"\u002F",[801,1462,1358],{"class":1357},[801,1464,1465],{"class":811},"bucket",[801,1467,1364],{"class":1357},[801,1469,1470],{"class":885},"\u002Fdata\u002Finstruments\u002Flabchip\u002Frun_001_PeakTable.csv\"\n",[801,1472,1473],{"class":803,"line":860},[801,1474,891],{"class":815},[801,1476,1477],{"class":803,"line":1032},[801,1478,832],{"emptyLinePlaceholder":831},[801,1480,1481,1484,1486,1488,1491,1493,1496],{"class":803,"line":1045},[801,1482,1483],{"class":807},"await",[801,1485,929],{"class":811},[801,1487,816],{"class":815},[801,1489,1490],{"class":934},"s3_service",[801,1492,816],{"class":815},[801,1494,1495],{"class":844},"upload_file",[801,1497,993],{"class":815},[801,1499,1500,1502,1504,1506,1508,1510],{"class":803,"line":1051},[801,1501,999],{"class":998},[801,1503,866],{"class":815},[801,1505,882],{"class":815},[801,1507,1106],{"class":885},[801,1509,882],{"class":815},[801,1511,1512],{"class":815},",\n",[801,1514,1515,1518,1520,1523],{"class":803,"line":1057},[801,1516,1517],{"class":998},"    s3_url",[801,1519,866],{"class":815},[801,1521,1522],{"class":844},"s3_url",[801,1524,1512],{"class":815},[801,1526,1528],{"class":803,"line":1527},9,[801,1529,891],{"class":815},[756,1531,1532,1533,1536,1537,1541],{},"Construct the S3 URL dynamically from values loaded out of the ",[782,1534,1535],{},"datalake-admin"," secret. See ",[1538,1539,544],"a",{"href":1540},"\u002Fobserve\u002Fconcepts\u002Fstorage\u002F"," for the URL format and credential loading pattern.",[787,1543,1545],{"id":1544},"putting-it-together","Putting it together",[756,1547,1548],{},"A complete async function that combines folder listing, change watching, and S3 upload:",[792,1550,1552],{"className":794,"code":1551,"language":796,"meta":797,"style":797},"from unitelabs.sdk import AsyncApiClient\n\n\nasync def monitor_and_upload(connector_name: str, s3_base_url: str) -> None:\n    \"\"\"Watch a connector for new files and upload each one to Object Storage.\"\"\"\n    async with AsyncApiClient() as client:\n        device = await client.get_service_by_name(connector_name)\n\n        whitelist = await device.folder_service.get_folder_whitelist()\n        print(f\"Watching {whitelist[0]} on '{connector_name}'\")\n\n        async with await device.folder_service.subscribe_changes() as sub:\n            async for file_path in sub:\n                meta = await device.file_service.get_file_metadata(path=file_path)\n                size = meta[\"Metadata\"][\"Size\"][\"value\"]\n                print(f\"Detected: {file_path} ({size} bytes)\")\n\n                filename = file_path.split(\"\u002F\")[-1]\n                s3_url = f\"{s3_base_url}\u002F{filename}\"\n\n                await device.s3_service.upload_file(path=file_path, s3_url=s3_url)\n                print(f\"Uploaded to: {s3_url}\")\n",[782,1553,1554,1568,1572,1576,1616,1627,1643,1664,1668,1689,1730,1735,1763,1780,1812,1850,1884,1889,1921,1952,1957,1992],{"__ignoreMap":797},[801,1555,1556,1558,1560,1562,1564,1566],{"class":803,"line":804},[801,1557,808],{"class":807},[801,1559,812],{"class":811},[801,1561,816],{"class":815},[801,1563,819],{"class":811},[801,1565,822],{"class":807},[801,1567,825],{"class":811},[801,1569,1570],{"class":803,"line":828},[801,1571,832],{"emptyLinePlaceholder":831},[801,1573,1574],{"class":803,"line":835},[801,1575,832],{"emptyLinePlaceholder":831},[801,1577,1578,1580,1583,1586,1588,1591,1593,1597,1600,1603,1605,1607,1610,1613],{"class":803,"line":860},[801,1579,838],{"class":1351},[801,1581,1582],{"class":1351}," def",[801,1584,1585],{"class":844}," monitor_and_upload",[801,1587,879],{"class":815},[801,1589,1590],{"class":998},"connector_name",[801,1592,1425],{"class":815},[801,1594,1596],{"class":1595},"sBMFI"," str",[801,1598,1599],{"class":815},",",[801,1601,1602],{"class":998}," s3_base_url",[801,1604,1425],{"class":815},[801,1606,1596],{"class":1595},[801,1608,1609],{"class":815},")",[801,1611,1612],{"class":815}," ->",[801,1614,1615],{"class":815}," None:\n",[801,1617,1618,1621,1624],{"class":803,"line":1032},[801,1619,1620],{"class":807},"    \"\"\"",[801,1622,1623],{"class":960},"Watch a connector for new files and upload each one to Object Storage.",[801,1625,1626],{"class":807},"\"\"\"\n",[801,1628,1629,1631,1633,1635,1637,1639,1641],{"class":803,"line":1045},[801,1630,1300],{"class":807},[801,1632,841],{"class":807},[801,1634,845],{"class":844},[801,1636,848],{"class":815},[801,1638,851],{"class":807},[801,1640,854],{"class":811},[801,1642,857],{"class":815},[801,1644,1645,1648,1650,1652,1654,1656,1658,1660,1662],{"class":803,"line":1051},[801,1646,1647],{"class":811},"        device ",[801,1649,866],{"class":815},[801,1651,869],{"class":807},[801,1653,854],{"class":811},[801,1655,816],{"class":815},[801,1657,876],{"class":844},[801,1659,879],{"class":815},[801,1661,1590],{"class":844},[801,1663,891],{"class":815},[801,1665,1666],{"class":803,"line":1057},[801,1667,832],{"emptyLinePlaceholder":831},[801,1669,1670,1673,1675,1677,1679,1681,1683,1685,1687],{"class":803,"line":1527},[801,1671,1672],{"class":811},"        whitelist ",[801,1674,866],{"class":815},[801,1676,869],{"class":807},[801,1678,929],{"class":811},[801,1680,816],{"class":815},[801,1682,935],{"class":934},[801,1684,816],{"class":815},[801,1686,940],{"class":844},[801,1688,943],{"class":815},[801,1690,1692,1695,1697,1699,1702,1704,1706,1708,1711,1714,1716,1719,1721,1723,1725,1728],{"class":803,"line":1691},10,[801,1693,1694],{"class":844},"        print",[801,1696,879],{"class":815},[801,1698,1040],{"class":1351},[801,1700,1701],{"class":885},"\"Watching ",[801,1703,1358],{"class":1357},[801,1705,953],{"class":844},[801,1707,1128],{"class":815},[801,1709,1710],{"class":1357},"0",[801,1712,1713],{"class":815},"]",[801,1715,1364],{"class":1357},[801,1717,1718],{"class":885}," on '",[801,1720,1358],{"class":1357},[801,1722,1590],{"class":844},[801,1724,1364],{"class":1357},[801,1726,1727],{"class":885},"'\"",[801,1729,891],{"class":815},[801,1731,1733],{"class":803,"line":1732},11,[801,1734,832],{"emptyLinePlaceholder":831},[801,1736,1738,1740,1742,1744,1746,1748,1750,1752,1754,1756,1758,1761],{"class":803,"line":1737},12,[801,1739,1329],{"class":807},[801,1741,841],{"class":807},[801,1743,869],{"class":807},[801,1745,929],{"class":811},[801,1747,816],{"class":815},[801,1749,935],{"class":934},[801,1751,816],{"class":815},[801,1753,1315],{"class":844},[801,1755,848],{"class":815},[801,1757,851],{"class":807},[801,1759,1760],{"class":811}," sub",[801,1762,857],{"class":815},[801,1764,1766,1769,1771,1774,1776,1778],{"class":803,"line":1765},13,[801,1767,1768],{"class":807},"            async",[801,1770,1332],{"class":807},[801,1772,1773],{"class":811}," file_path ",[801,1775,1024],{"class":807},[801,1777,1760],{"class":811},[801,1779,857],{"class":815},[801,1781,1783,1786,1788,1790,1792,1794,1796,1798,1800,1802,1805,1807,1810],{"class":803,"line":1782},14,[801,1784,1785],{"class":811},"                meta ",[801,1787,866],{"class":815},[801,1789,869],{"class":807},[801,1791,929],{"class":811},[801,1793,816],{"class":815},[801,1795,1088],{"class":934},[801,1797,816],{"class":815},[801,1799,1093],{"class":844},[801,1801,879],{"class":815},[801,1803,1804],{"class":998},"path",[801,1806,866],{"class":815},[801,1808,1809],{"class":844},"file_path",[801,1811,891],{"class":815},[801,1813,1815,1818,1820,1823,1825,1827,1829,1831,1833,1835,1837,1839,1841,1843,1845,1847],{"class":803,"line":1814},15,[801,1816,1817],{"class":811},"                size ",[801,1819,866],{"class":815},[801,1821,1822],{"class":811}," meta",[801,1824,1128],{"class":815},[801,1826,882],{"class":815},[801,1828,1133],{"class":885},[801,1830,882],{"class":815},[801,1832,1138],{"class":815},[801,1834,882],{"class":815},[801,1836,1143],{"class":885},[801,1838,882],{"class":815},[801,1840,1138],{"class":815},[801,1842,882],{"class":815},[801,1844,1152],{"class":885},[801,1846,882],{"class":815},[801,1848,1849],{"class":815},"]\n",[801,1851,1853,1856,1858,1860,1863,1865,1867,1869,1872,1874,1877,1879,1882],{"class":803,"line":1852},16,[801,1854,1855],{"class":844},"                print",[801,1857,879],{"class":815},[801,1859,1040],{"class":1351},[801,1861,1862],{"class":885},"\"Detected: ",[801,1864,1358],{"class":1357},[801,1866,1809],{"class":844},[801,1868,1364],{"class":1357},[801,1870,1871],{"class":885}," (",[801,1873,1358],{"class":1357},[801,1875,1876],{"class":844},"size",[801,1878,1364],{"class":1357},[801,1880,1881],{"class":885}," bytes)\"",[801,1883,891],{"class":815},[801,1885,1887],{"class":803,"line":1886},17,[801,1888,832],{"emptyLinePlaceholder":831},[801,1890,1892,1895,1897,1900,1902,1905,1907,1909,1911,1913,1916,1919],{"class":803,"line":1891},18,[801,1893,1894],{"class":811},"                filename ",[801,1896,866],{"class":815},[801,1898,1899],{"class":811}," file_path",[801,1901,816],{"class":815},[801,1903,1904],{"class":844},"split",[801,1906,879],{"class":815},[801,1908,882],{"class":815},[801,1910,1460],{"class":885},[801,1912,882],{"class":815},[801,1914,1915],{"class":815},")[-",[801,1917,1918],{"class":1357},"1",[801,1920,1849],{"class":815},[801,1922,1924,1927,1929,1932,1934,1936,1939,1941,1943,1945,1948,1950],{"class":803,"line":1923},19,[801,1925,1926],{"class":811},"                s3_url ",[801,1928,866],{"class":815},[801,1930,1931],{"class":1351}," f",[801,1933,882],{"class":885},[801,1935,1358],{"class":1357},[801,1937,1938],{"class":811},"s3_base_url",[801,1940,1364],{"class":1357},[801,1942,1460],{"class":885},[801,1944,1358],{"class":1357},[801,1946,1947],{"class":811},"filename",[801,1949,1364],{"class":1357},[801,1951,1009],{"class":885},[801,1953,1955],{"class":803,"line":1954},20,[801,1956,832],{"emptyLinePlaceholder":831},[801,1958,1960,1963,1965,1967,1969,1971,1973,1975,1977,1979,1981,1983,1986,1988,1990],{"class":803,"line":1959},21,[801,1961,1962],{"class":807},"                await",[801,1964,929],{"class":811},[801,1966,816],{"class":815},[801,1968,1490],{"class":934},[801,1970,816],{"class":815},[801,1972,1495],{"class":844},[801,1974,879],{"class":815},[801,1976,1804],{"class":998},[801,1978,866],{"class":815},[801,1980,1809],{"class":844},[801,1982,1599],{"class":815},[801,1984,1985],{"class":998}," s3_url",[801,1987,866],{"class":815},[801,1989,1522],{"class":844},[801,1991,891],{"class":815},[801,1993,1995,1997,1999,2001,2004,2006,2008,2010,2012],{"class":803,"line":1994},22,[801,1996,1855],{"class":844},[801,1998,879],{"class":815},[801,2000,1040],{"class":1351},[801,2002,2003],{"class":885},"\"Uploaded to: ",[801,2005,1358],{"class":1357},[801,2007,1522],{"class":844},[801,2009,1364],{"class":1357},[801,2011,882],{"class":885},[801,2013,891],{"class":815},[787,2015,2017],{"id":2016},"next-steps","Next steps",[766,2019,2020,2025],{},[769,2021,2022,2024],{},[1538,2023,544],{"href":1540}," — understand the S3 URL scheme, bucket layout, and credentials",[769,2026,2027,2030],{},[1538,2028,564],{"href":2029},"\u002Fobserve\u002Fguides\u002Fbuilding-an-etl\u002F"," — embed this pattern in a production Prefect flow with startup reconciliation and Warehouse writes",[2032,2033,2034],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sHdIc, html code.shiki .sHdIc{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#EEFFFF;--shiki-default-font-style:italic;--shiki-dark:#BABED8;--shiki-dark-font-style:italic}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}",{"title":797,"searchDepth":804,"depth":828,"links":2036},[2037,2038,2039,2040,2041,2042,2043,2044],{"id":789,"depth":828,"text":790},{"id":904,"depth":828,"text":905},{"id":964,"depth":828,"text":965},{"id":1063,"depth":828,"text":1064},{"id":1239,"depth":828,"text":1240},{"id":1388,"depth":828,"text":1389},{"id":1544,"depth":828,"text":1545},{"id":2016,"depth":828,"text":2017},"A practical example of using the file system connector to read and write data in workflows.","md",null,{},{"title":560,"description":2045},"tAfRgqfJFUWc1gVJkU688sUH_weeYX6mQsTqw7aPNVk",[2052,2054],{"title":552,"path":553,"stem":554,"description":2053},"Connect to and manage data sources in the UniteLabs Platform.",{"title":564,"path":565,"stem":566,"description":2055},"Extract, transform, and load data between lab instruments and external systems using UniteLabs.",1783607797138]