Opentrons 很高興為協(xié)議設計器發(fā)布改進的批量編輯選項。 以下是您需要了解的有關其工作原理的所有信息。

此功能升級直接來自客戶反饋順滑地配合。 謝謝你和諧共生！ 我們很高興聽到您的想法——請繼續(xù)提出！

當協(xié)議設計器 (PD) 首次創(chuàng)建時善謀新篇，Opentrons 設想了一個平臺，科學家可以在其中快速構(gòu)建基本的移液協(xié)議便利性，而無需編寫任何代碼方法。 隨著 PD 越來越多地被我們社區(qū)所利用，它成為一種工具提供有力支撐，使科學家能夠構(gòu)建冗長而復雜的方案切實把製度，以解決 DNA 提取、蛋白質(zhì)純化和 COVID-19 診斷等應用自行開發。 當我們開始看到科學家使用 PD 構(gòu)建包含 100 多個步驟的方案時進行部署，我們知道我們需要為他們提供更好的方法來優(yōu)化和編輯他們的方案。 科學家們有足夠多的擔憂：我們不希望他們花時間一遍又一遍地乏味地改變相同的設置應用情況。

所以保護好，我們剛剛向 PD 添加了批量編輯模式！ 用戶現(xiàn)在可以選擇表現、復制運行好、刪除和編輯多個步驟，從而能夠更快地迭代和優(yōu)化科學協(xié)議可能性更大。

在產(chǎn)品開發(fā)團隊開始考慮如何完成此功能之前部署安排，我們就知道這將是一個巨大的工程挑戰(zhàn)。 擴展 PD 這樣的應用程序以支持完全不同的用戶流程（例如批量編輯）將需要大量重構(gòu)關鍵技術，這會影響 Protocol Designer 的核心部分了解情況。 這篇文章將從工程角度重點討論此功能深入，但我也想指出完成此功能所面臨的巨大設計挑戰(zhàn)技術研究。 PD 的核心原則之一是易用性，打造易于使用開展研究、直觀的用戶體驗來構(gòu)建和優(yōu)化復雜的科學協(xié)議絕非易事姿勢。

專為一次編輯一個步驟而設計

PD 旨在從頭開始構(gòu)建科學方案，依次創(chuàng)建和編輯步驟首要任務。 流程如下：

1. 用戶創(chuàng)建一個步驟（轉(zhuǎn)移綠色化、混合、加熱等）
2. 在表格中填寫相關步驟信息（移液器發展、實驗室器皿保持穩定、液體體積等）
3. 保存表格
4. 創(chuàng)建下一步
5. 等等

這意味著在任何給定時間，PD 中的主“設計”選項卡都會顯示以下部分/全部內(nèi)容：

1. 協(xié)議中所有步驟的列表
2. 協(xié)議特定步驟的視覺快照
3. 供用戶填寫的表格面向，以指定該步驟應執(zhí)行的操作

PD 的 UI 組件（內(nèi)置于 React）和全局狀態(tài)管理存儲（在 Redux 中實現(xiàn)）就是為了適應這種用戶流程而構(gòu)建的支撐作用。 這意味著 PD 的 redux 存儲會跟蹤“選定步驟”之類的內(nèi)容，以便用戶可以直觀地看到協(xié)議的特定部分實際發(fā)生的情況建設項目。 它還會跟蹤“未保存的表單”等內(nèi)容最為突出，在提交之前跟蹤待處理的更改落實落細。

請注意上面捕獲的數(shù)據(jù)的奇異性（選定的步驟，未保存的形式）高效化。 PD 的 redux 存儲和 React 組件旨在與一個步驟交互製高點項目，而不是多個步驟。 為了說明這一點範圍和領域，讓我們看看 PD 如何根據(jù)選擇的步驟填充實驗室器皿上的孔（這就是上圖中孔顯示為綠色的方式）有所增加。

1. 用戶點擊一個步驟
2. 調(diào)度一個名為“SELECT_STEP”的 redux 操作，更新“所選項目”reducer
3. 偵聽“所選項目”更改的 redux 選擇器將搜索該特定步驟中正在使用的實驗室器皿和孔
4. 孔信息將傳遞到名為“LabwareRender”的組件中更高要求，然后該組件將使用該信息對孔進行著色

但是反應能力，當我們開始跟蹤多個選定步驟而不是僅跟蹤一個步驟時，會發(fā)生什么情況呢學習？ 特別是奮戰不懈，上面的步驟 3 會發(fā)生什么？ 如果我們選擇了多個項目措施，我們該怎么辦大大縮短？

為了防止同時選擇/編輯多個步驟時組件損壞，我們必須對數(shù)據(jù)的表示和轉(zhuǎn)換方式進行核心更改緊密相關。 讓我們回顧一下我們所做的事情更默契了。

跟蹤多個選定的步驟

在此功能之前，我們僅在 Redux 存儲中跟蹤單個“selectedItem”培訓。 我們的“selectedItem”reducer 類型接口類似于下面的代碼片段不合理波動。 請注意，本文中的所有代碼片段均采用 JavaScript 編寫重要工具，并使用 flow js 鍵入積極拓展新的領域。

減速器函數(shù)“selectedItem”接受狀態(tài)和操作，并返回所選項目（保存所選項目相關信息的對象）更優質，如果沒有所選項目相對開放，則返回 null。

為了避免在批量編輯模式下添加新的縮減器來保存多個步驟脫穎而出，我們選擇修改“selectedItem”縮減器以適應返回單個步驟和多個步驟拓展應用。

“selectedItem”的返回類型已修改為能夠保存包含單個步驟 id 的對象（代表單一選擇類型），或包含多個步驟 id 列表的對象（代表多重選擇類型） 結構。 為了告訴 redux 我們已經(jīng)選擇了多個步驟管理，我們創(chuàng)建了一個名為“SELECT_MULTIPLE_STEPS”的操作，“selectedItem”reducer 函數(shù)將接受該操作能力建設，并更新其值以表示多個步驟（請參閱類型“MultipleSelectedItem”）

名為“selectedItem”的減速器肯定會有些尷尬模樣，它可能保存表示多個項目的數(shù)據(jù)，但我們最終決定，這種權衡是值得的提供了遵循，不必添加額外的減速器來表示多個選定的項目參與水平，從而必須取消一個或多個項目 另一個是在單個編輯模式和批量編輯模式之間切換時。

為了防止過去只接受一個步驟作為 props 的組件被破壞服務效率，我們能夠利用 redux 選擇器模式將來自減速器的數(shù)據(jù)轉(zhuǎn)換為我們的組件可以接受的格式明確相關要求。 將有關所選步驟的信息提供給我們的組件的主選擇器稱為“getSelectedStepId”，它曾經(jīng)執(zhí)行以下操作：

這是選擇器過去所做的事情的簡化統籌發展，但你明白了——它基本上進入了“selectedStep”減速器并返回其中的任何內(nèi)容深化涉外。 因為我們的組件從選擇器而不是減速器獲取選定的步驟，所以我們能夠首先轉(zhuǎn)換減速器中保存的數(shù)據(jù)逐漸完善，然后再將其輸入到我們的組件中參與能力。

這意味著我們所要做的就是修改“getSelectedStepId”以在reducer保存“單選擇類型”時返回步驟id，否則返回null：

由于我們現(xiàn)有的組件現(xiàn)在能夠處理選擇的多個步驟是目前主流，因此我們添加了一個名為“getMultiSelectItemIds”的新選擇器充分發揮，它類似于“getSelectedStepId”，但在批量編輯模式下返回步驟 ID 列表充分發揮，否則返回 null選擇適用。 該選擇器將用于告訴 PD 在批量編輯模式下選擇了哪些步驟。

從減速器 => 選擇器 => 組件中獲取數(shù)據(jù)流確實對我們有幫助，因為我們能夠更改減速器的結(jié)構(gòu)，而不必擔心組件損壞越來越重要。 此外，由于我們使用 reselect 將選擇器組合在一起合作關系，因此所有使用“getSelectedStepId”的高階選擇器仍然可以正常工作。

填充批量編輯表單

PD 根據(jù)規(guī)則矩陣確定多個步驟中的哪些字段是可編輯的。 例如，如果用戶選擇兩個轉(zhuǎn)移步驟結構不合理，并且這兩個步驟具有不同的移液器，則他們不應能夠修改兩個步驟之間共享的移液器流速設置逐步顯現。

使用規(guī)則矩陣銘記囑托，我們創(chuàng)建了另一個名為“getMultiSelectDisabledFields”的 redux 選擇器引領，顧名思義自動化裝置，它確定在多選模式下應禁用哪些字段。 它會迭代所選表單中的所有字段應用前景，并確定表單是否共享相同的移液器有很大提升空間、實驗室器具等。根據(jù)每個字段的規(guī)則首次，它將返回哪些字段被禁用的映射以及每個字段被禁用的原因可能性更大。 字段被禁用。 然后，批量編輯表單組件可以使用此信息來填充哪些字段可編輯技術，哪些字段不可編輯推廣開來。

跟蹤批量編輯更改

填充批量編輯表單的字段后，需要在用戶修改它們時跟蹤其值的更改相對較高。 這是出于以下幾個原因：

1. 我們需要知道用戶是否對表單進行了任何更改資源配置，因為如果他們進行了更改，我們想提醒他們大幅增加，如果他們嘗試退出表單特性，他們將丟失這些更改。
2. 一旦他們完成更改等特點，我們需要將他們所做的未保存的更改（影響多個步驟）合并到 PD 全局狀態(tài)內(nèi)已保存的步驟映射中建言直達。

對于單一編輯模式，有另一個名為“unsavedForm”的減速器將進一步，它將所有信息保存在單個未保存的表單中充分發揮，但我們決定不在批量編輯模式中重用它，因為：

1.批量編輯表單保存多個表單的信息成就，而不僅僅是一個表單

2. 在批量編輯模式下同時，僅保存有關哪些表單字段已更改的信息要有用得多。 這樣效高性，當用戶保存批量編輯表單時模式，我們所要做的就是將更改擴展到保存所有已保存表單信息的“savedStepForms”縮減程序中的每個受影響的步驟。 這也意味著只要表示更改的對象不為空提升，我們就知道用戶已進行更改高品質。

為了實現(xiàn)這一點，我們創(chuàng)建了一個名為“batchEditFormChanges”的新減速器支撐能力，它包含一個純 JavaScript 對象資源優勢，將編輯的字段名稱表示為鍵，以及關聯(lián)的字段值特征更加明顯。

重用表單組件

PD 的表單組件非彻浪?！爸悄堋保驗樗鼈冞B接到 redux的可能性，因此可以訪問表單數(shù)據(jù)不要畏懼。 問題在于“智能”組件中的邏輯直接與單一編輯模式相關。 為了消除單一編輯模式的依賴問題，我們決定在單一編輯模式和批量編輯模式下注入表單組件逐漸顯現，并使用一組共享名為“FieldProps”的通用 API 的 props

為了實現(xiàn)這一目標，我們創(chuàng)建了兩個單獨的函數(shù)（一個用于單一編輯模式系統穩定性，一個用于批量編輯模式）拓展基地，負責計算上面的每個“FieldProps”。 它們被恰當?shù)孛麨椤癿akeSingleEditFieldProps”和“makeBatchEditFieldProps”。 單一編輯表單的主要父組件使用前者分享，而批量編輯表單的對應組件則使用后者共享。

這兩個純函數(shù)都獲取相應的單編輯/批量編輯狀態(tài)信息（例如每個表單中包含哪些信息），執(zhí)行必要的邏輯方式之一，并返回一個包含與上面相同的“FieldProps”接口的對象全面闡釋。 這意味著只要我們所有的表單組件接受“FieldProps”接口，它們就可以用于單一編輯模式和批量編輯模式競爭力所在。

將我們現(xiàn)有的表單組件從耦合的單一編輯模式邏輯中遷移出來是一項相當大的工作（而且我們還有更多工作要做）引人註目，但是創(chuàng)建這個通用的 props 接口允許我們重用現(xiàn)有的表單字段組件，同時繪制一個 單一編輯模式邏輯和批量編輯模式邏輯之間的清晰界限溝通機製。

要點

上述所有工作（以及更多）花了我們由三名工程師好宣講、一名設計師、一名產(chǎn)品經(jīng)理和一名質(zhì)量檢查工程師組成的團隊大約三個月的時間才完成領先水平。 您可以在此處查看我們用于選擇多個步驟的史詩，以及用于批量編輯表單特定工作的史詩。 我們的所有工作都是開源的戰略布局，因此請隨意瀏覽我們的代碼庫事關全面。

在開始開發(fā)此功能之前，我們問自己整個季度的投資是否值得狀態。 由于批量編輯是迄今為止用戶最常見的功能請求技術節能，因此我們最終決定如此。 然而廣泛認同，值得注意的是國際要求，用戶想要同時編輯多個步驟的原因是因為他們的協(xié)議通常包含許多步驟，這些步驟更容易批量編輯鍛造，而不是一次編輯一個競爭激烈。 隨著越來越多的科學家使用 PD 來解決越來越復雜的問題，包含許多步驟的協(xié)議問題將會增加改善。

展望未來空白區，我們希望更好地了解用戶到底在使用 PD 構(gòu)建什么，以及我們可以采取哪些措施來幫助他們最大限度地減少創(chuàng)建步驟信息化。 隨著 PD 的不斷發(fā)展和發(fā)展形勢，我們將努力回答這些問題。 雖然我們對此功能感到非常興奮充分發揮，但我們的使命是讓科學家能夠更快地采取行動選擇適用，并解決我們迫切需要他們解決的問題，這一使命還遠未結(jié)束推動並實現。