# **項目基本設置**
*****
您必須具有項目設計和安裝權限才能在“項目設置”頁上執行操作。
權限是在項目的用戶權限中設置的,對項目中的每個用戶都是唯一的。
## **“項目設置”頁上的步驟1:主項目設置**
選擇數據收集類型:
### **1. 使用縱向數據收集**
默認情況下,由空白(不是模板)創建的項目是典型的數據收集項目。如果希望將其配置為縱向收集數據,可以單擊“**項目設置**”頁上第一部分中的“**啟用**”按鈕。要確定項目應為經典還是縱向,請考慮以下比較:

### **2. 在本項目中使用調查**
如果項目將包含調查,請單擊“**啟用**”。
> **提醒:**
>
> 根據上面的有用術語,如果輸入數據的人不是項目的用戶,則可以啟用調查。例如,如果一個研究參與者正在輸入關于他們自己的數據。
### **3. 修改項目名稱、目的等**
如果要更改項目標題或目的,請單擊此圖標。

完成主項目設置后,單擊“**我已完成!**“這將作為本節已完成的視覺復選標記。
注意:在開發模式下,您始終可以返回并更改設置。

## **“項目設置”頁上的步驟2:設計數據收集工具**
* **聯機設計器**:單擊聯機設計器開始生成數據收集工具
* **數據字典**:或者,您可以通過Excel?csv文件上傳數據字典,以便構建數據收集工具。
> **注意**:這被認為是一個高級步驟,除非您是一個有經驗的用戶,否則不應使用。

### **1. 導航到聯機設計器**
您可以通過左側導航欄上的“**項目頁面和項目設計**”下的“**在線設計**”鏈接訪問聯機設計器:

### **2. 數據收集工具**
術語“**工具**”指的是在字段中輸入和查看數據的離散頁面時與“**表格**”同義。在這種情況下,“**字段**”和“**變量**”也基本上是同義的。
REDCap提供了兩種創建和編輯數據采集工具的方法:使用在線設計器和通過上載以CSV格式組成的數據字典文件,通常使用Microsoft?Excel。
有關儀器開發的視頻介紹,請參見[此鏈接]()。長度是6分半鐘。您可以通過單擊培訓視頻從“**主頁**”或“**我的項目**”選項卡訪問視頻。如果您在REDCap項目中,請查看導航欄底部“**幫助和信息**”部分下的左側導航欄。
### **3. CSV文件說明**
CSV文件是簡單的純文本,每行一條記錄,每列用逗號分隔,即每條記錄中的每個單獨值用逗號分隔(CSV是“**逗號分隔值**”的縮寫)。在Windows計算機上,CSV文件默認設置為使用Excel打開,Excel通常使用逗號將值分隔成列,但CSV文件不是Excel文件。
請注意,Excel對自動數據格式化沒有多大幫助:它會導致您丟失CSV數據中的格式信息,如前導零和特定日期格式......

最好在Excel中打開CSV文件,而不是以通常的方式雙擊該文件,而是打開一個空白的Excel工作表并使用導入向導:在功能區的“**數據**”選項卡上是“**文本**”選項。

使用此方法,可以指定希望Excel將部分(或全部)列視為文本,從而完全按照數據在源文件中的顯示方式顯示數據,而不使用Excel對所要查看內容的意見。
### **4. 在線設計**
在線設計者列出了項目中存在的儀器,并提供了在儀器級操縱它們的功能(與儀器內的項目操作相反)。通過單擊左側導航欄(在“**項目主頁和設計**”下)上的“**在線設計**”或單擊“**項目設置**”頁上的“在線設計器”按鈕,可以訪問在線設計器。

#### **4.1 創建新窗體**
1. 單擊“**創建**”
2. 在列表中要創建新表單的位置單擊此處的“**添加工具**”(稍后可以更改)
3. 指定名稱并單擊“**創建**”
4. 向窗體中添加變量。在至少添加一個變量之前,將不會保存新表單。

#### **4.2 刪除表單(在在線設計器中)**
1. 單擊相關表單的“**刪除**”按鈕(在“**操作**”下)
2. 確認刪除。表單及其所有變量都將被刪除
#### **4.3 在在線設計器中重新排序表單(移動工具)**
1. 將鼠標光標放在窗體行的左端
2. 單擊并將行拖動到新位置

#### **4.4 移動工具時的注意事項**
如果您的項目中有調查,并且希望使用公共調查鏈接,則您的調查需要是項目中的第一個工具,如下圖所示:

如果數據輸入表單是第一個,如下圖所示

則您的公共調查鏈接將被禁用。
移動工具時還要記住分支邏輯、管道和計算。例如,假設您計劃將數據輸入到數據輸入表單A中,該表單定位為項目中的第一個工具,然后將被管道傳輸到數據輸入表單B中,該表單定位為項目中的第二個工具。如果將數據輸入表B移動為第一個儀表,并首先將數據輸入到該表中,則數據輸入表A上應顯示管道的字段將沒有值。
此外,如果啟用了調查隊列或自動繼續,請檢查重新排序儀器對這些功能的影響。
最后,最好檢查調查設置,查看是否需要調整調查說明和/或確認電子郵件(如果已啟用)的措辭。若要獲取調查設置,請單擊左側導航欄上“項目主頁和設計”下的“設計器”。
請注意,如果更改第一個調查(例如,將調查B移到調查A之前),則會更改公共調查鏈接。如果在移動調查之前創建了自定義公共調查鏈接,則該自定義公共調查鏈接將不再有效。任何單擊舊調查鏈接的參與者都將收到消息:*感謝您的關注,但您不是此調查的參與者*。若要解決此問題,請刪除自定義公共調查鏈接,然后重新創建它。
#### **4.5 在在線設計器中重命名表單**
REDCap將從一個名為“**我的第一個工具**”的數據收集工具開始您的項目。您需要更改標題,使其反映您在其中收集的數據。
1. 單擊表單的“重命名”按鈕(在“操作”下)
2. 輸入新名稱并單擊“保存”

### **5. 在儀器內設計**
要開始構建數據收集工具,請單擊工具名稱。
> **設計提示 1:在設計儀器時添加測試記錄**
>
> 這有助于確保儀器按您的意愿提供。由于REDCap項目是一系列網頁,因此可以在一個瀏覽器選項卡上打開在線設計器,然后在另一個瀏覽器選項卡上打開添加/編輯記錄。只需在兩個選項卡之間來回切換,即可從設計切換到添加測試數據。
> **設計提示 2:參與者識別數據**
>
> 仔細考慮在你的項目中到底需要什么樣的機密、參與者識別數據。建議將標識信息與其他項目數據分開保存,這是可以做到的——通過確保所有標識字段(請參閱[檢查標識]())都位于其他數據的單獨表單上,并將對這些表單的訪問限制在最小用戶集內,以安全性的降序排列
#### **記錄標識符**
與任何數據庫一樣,項目記錄必須是唯一可標識的。REDCap項目必須將“**記錄標識符**”字段定義為對項目的數據收集表單所做的任何更改中第一個表單上的第一個字段記錄標識符字段必須保留為第一個表單的第一個字段。無法刪除記錄標識符字段;但是,可以通過單擊鉛筆圖標重命名此字段。
### **6. 用戶生成的記錄標識符或自動編號標識符**
記錄標識符可以自動按順序生成(自動編號)或由用戶輸入。
用戶輸入標識符的一個很好的例子是患者的醫療記錄號(MRN)。這是因為MRN是唯一的,記錄標識符必須是唯一的。一個不好的例子是參與者的姓氏,因為可能有幾個人的姓氏相同(例如史密斯、瓊斯等)。

### **7. 通過在線設計器向數據收集工具添加字段(向數據收集工具添加問題)**
1. 單擊此處添加字段?
2. “**添加新字段**”對話框打開

3. 從以下幾種可用字段類型中選擇一種:

4. 輸入字段元素(請參閱下面的**進一步信息**)
5. 單擊“**保存**”按鈕
### **8. 選擇字段類型**
一般來說,最好選擇一種字段類型,以定量方式收集數據。例如,選擇多項選擇字段類型選項之一,并提供一個選項列表,而不是選擇文本框或備注框字段類型并讓用戶輸入自己的文本。這樣可以防止輸入錯誤并確保數據收集的一致性。定量問題將產生圖形和統計結果。
如果收集字母數字文本,請盡可能添加驗證以限制輸入的文本類型。文本框字段類型中提供了對這些數據點的驗證:
> Date
> Email
> Integer
> Number
> Phone?(North?America)
> Time
> Vanderbilt?MRN
> Zip?code?(US)
### **9. 字段元素**
選擇字段類型后,以下是一些可用的元素:
1. **字段標簽**:這是設置問題或數據字段格式的地方。
2. **字段注釋**:主要用于輸入動作標記和注釋。這些注釋不會出現在您的數據收集工具或調查中。
3. **變量名**:這是存儲在數據庫中的字段標簽的名稱,可用于報告、導出和分析。變量名可以包含字母、數字和下劃線,但不能包含空格或特殊字符。如果決定在將項目移入生產環境之前更改變量的名稱,則必須在使用該變量的所有位置(如計算、分支邏輯等)進行更改。
4. **必選**:說明是否需要你的領域。所有字段的默認設置都設置為“否”。
5. **標識符**:指示字段是否為標識符。所有可能識別一個人的字段都應標記為標識符,而不管誰將訪問您的數據。特別是對于研究項目,您需要適當地標記標識字段。這樣,如果需要取消標識數據,就可以輕松地執行此操作。
> ??????要符合HIPAA,必須在項目中標記為標識符的信息有如下18條:
> ??????????名稱
> ??????????傳真號碼
> ??????????電話號碼
> ??????????電子郵件地址
> ??????????賬號
> ??????????社會保險號碼
> ??????????醫療記錄編號
> ??????????健康計劃編號
> ??????????證書/許可證編號
> ??????????網址
> ???????? ?IP地址
> ??????????車輛標識
> ??????????設備ID
> ??????????生物識別
> ??????????正面/識別照片
> ??????????其他唯一的識別號、特征或代碼
> ??????????郵政地址(小于州的地理分區)
> ??????????日期精度超過一年
6. **自定義對齊**:選擇字段的對齊方式。默認設置為“右/垂直”。
7. **字段注釋**:使用此字段可以為輸入數據的人輸入任何注釋、提醒或說明。
> **設計提示 3:變量名**
>
> 變量名在整個項目中必須是唯一的。最好的做法是用描述性的方式命名變量。例如,如果在一個項目中收集多個日期,請為每個日期提供一個變量名,以標識日期與項目的關系(訪問日期、屏幕日期)。這使得數據導出(利用變量名)具有清晰的標識信息,從而區分變量。
### **11. 操作標記**
動作標簽是定制調查和表單數據輸入體驗的一種很好的方法。它們是以“@”符號開頭的特殊術語,可以在添加或編輯字段時放在字段的字段批注中。
每個動作標記都有一個對應的動作,當顯示在數據輸入表單和調查頁面上時,該動作會針對字段執行。
對于單個字段,可以使用任意多個標記,但如果確實對字段使用多個標記,請確保在它們之間放置空格或換行符。
由于操作標記用作字段批注的一部分,因此它們不會顯示在頁面上的任何位置。若要開始使用操作標記,請導航到項目中的在線設計器,然后在添加或編輯字段時,將標記添加到“**編輯字段**”彈出窗口中的“**操作標記/字段批注**”文本框中。
有關所有動作標記的列表和定義,請參見此鏈接[鏈接](https://is.gd/ActionTagDemo)學習在線教程:
請注意動作標簽是區分大小寫的。如果選擇手動在“**操作標記**”框中鍵入操作標記(而不是單擊“**操作標記**”鏈接并單擊“**添加**”按鈕),則需要將操作標記寫入所有大寫字母。例如,如果要鍵入@hidden?survey,REDCap將無法識別該語法。它需要成為“@HIDDEN-SURVEY”。同樣,如果在操作標記中引用變量名(就像使用默認操作標記時一樣),則需要確保變量名的大小寫都是小寫的。
### **12. 文本框字段元素**
對于文本框字段,您有此附加元素:
> **驗證**:對于字段類型文本框(短文本),您有機會選擇驗證。如果要指示如何輸入此字段中的數據,請使用下拉列表并選擇一個選項。
### **13. 多選字段附加元素**
**選項**:為問題輸入預先確定的選項,每行一個:

### **14. 字段類型示例**
> **設計提示 4:選擇字段類型**
>
> 為了確定所需的字段類型,請考慮要收集的數據類型。一般來說,如果數據可以從定量和定性兩個方面來獲取,那么它更具可操作性。把封閉式問題和開放式問題想得更好。所以,想想你所問的問題,看看它是否能以一種封閉的方式來構建。例如,如果要創建員工目錄,則目錄中可以有一個字段詢問員工的主管是誰。從技術上講,你可以把它當作一個開放式的問題。但如果是一個簡短的監管者名單,最好將其列為多項選擇題,并將所有潛在的監管者列為該問題的選擇。
#### **14.1. 收集字母數字文本**
如果需要輸入數據的人輸入字母數字文本(而不是從預定的選擇中選擇),則可以選擇文本框或備注框作為字段類型。
如果要輸入的文本很簡短,請選擇文本框。如果要為響應留出更多空間,請選擇“**備注**”框。在數據輸入表單或調查中,您將看到這兩個選項看起來不同,因為“備注”框更大。
如果希望文本符合特定格式(如日期、電子郵件地址、電話號碼等),請選擇文本框字段類型。這將允許您添加驗證,強制輸入數據的人以指定的格式輸入數據。
#### **14.2. 文本框(短文本)**
此字段可用于捕獲字母數字文本。盡可能使用“**驗證**”下拉列表來限制應如何輸入數據。

> **設計提示 5:收集名稱**
>
> 收集人名時,最好創建兩個單獨的字段:一個用于名,一個用于姓。這有助于對記錄進行排序。
**驗證類型:**
* 日期
* 電子郵件地址
* 整數
* 數字
* 電話號碼(北美)
* 時間
* 范德堡大學MRN
* 郵政編碼(美國)
* 帶日期驗證的文本框(短文本)(M-D-Y)
下面的示例是帶有范圍檢查(最小字段和最大字段)的文本框字段。該字段按要求標記,并包含一個字段注釋。
如何在在線設計器中顯示:

在輸入數據的人看來:

帶有電子郵件驗證的文本框(短文本)

帶數字驗證的文本框(短文本)(允許小數)

作為一般規則,在使用數字驗證時指定范圍很有幫助。
驗證為整數(整數)的文本框(短文本),此字段具有范圍檢查(最小和最大字段),標記為必需的,并包含一個子集。

作為一般規則,在使用整數驗證時指定范圍很有幫助。
#### **14.3.?備注框(段落文本)**
當您希望捕獲定性數據并希望輸入數據的人有足夠的空間輸入數據時,這種字段非常有用。您將看到它是一個比文本框字段更大的框。

#### **14.4 計算字段**
此字段可以基于其他字段的數據執行實時計算。例如,您可以基于“**出生日期**”字段和“**就診日期**”字段創建一個計算,以了解參與者在就診時的年齡。

因此,要使用計算字段,必須創建兩個或多個其他字段,計算字段將從中進行計算。從中提取計算字段的字段必須是驗證為數字、整數或日期的文本框字段。
計算結果必須是數字,而不是文本、布爾值或日期/日期時間。
強烈建議您不要在年齡計算字段中使用“**今天**”。這是因為每次訪問和保存儀器時,都會運行計算。因此,如果您計算截止到今天的年齡,一年后當您訪問儀器進行檢查或更新時,截止到“**今天**”的年齡也將更新(+1年)。最佳實踐是利用在研究過程中收集的字段(例如,固定日期,如篩選日期、注冊日期)計算年齡。
**建立我的計算**
如果您需要幫助編寫計算,請轉到[此鏈接](https://redcap.vanderbilt.edu/surveys/?s=YEXWAXDFL4)并提供所需的信息。該鏈接是一個在線的交互式教程,旨在幫助您一步一步地構建紅字計算。提供計算的框架,然后填空。有多少空格,需要什么樣的信息將取決于您要生成的計算。當您指定不同的元素時,您可以在頁面底部看到它們被實時添加到計算中。
> **設計提示 6:計算字段**
>
> 輸入計算時,公式中的語法非常重要。注意使用方括號(用于指定REDCap變量和事件名)和圓括號(用于對數學表達式進行分組)之間的區別。項目中的變量名可以用作公式中的變量,但必須在每個變量周圍放置\[\]方括號。在構造方程時,請確保遵循運算的數學順序。注意開引號和閉引號以及括號和圓括號。
#### **14.6 多項選擇**
> **設計提示 7:下拉列表還是單選按鈕?**
>
> 解決這個問題部分取決于個人偏好,但也要考慮誰以及如何使用數據輸入表單。作為建議:
> 廣播組最適合用于調查表格,或用于不經常輸入數據的用戶的數據輸入表格,因為所有可能的選擇都顯示在表格上
> 數據輸入表單首選下拉列表,因為您可以使用鍵盤輸入(例如,如果您的標簽為“**是/否**”,則為“**是/否**”)或數字鍵盤(例如,如果您的標簽為“**1是/0否**”,則為1/0)來選擇選項
在數據輸入用戶缺乏經驗的情況下,也可以使用單選按鈕(即鼠標單擊):從單選組中選擇一個選項是用鼠標單擊一次,而不是為下拉列表單擊兩次(或按選擇釋放)。但有經驗的計算機/數據輸入用戶可能更喜歡下拉列表提供的無鼠標使用體驗。
**多項選擇下拉列表(單一答案)**
此字段將以下拉列表的形式顯示您的答案選擇。當你有一長串的選擇并且想要節省屏幕空間時,這很有幫助。
當一個字段包含多個答案選項時,必須為每個答案選項提供一個原始值。如果沒有,REDCap將自動為您分配它們。

**自動完成下拉選擇**
REDCap具有下拉字段的自動完成功能。啟用后,它允許參與者或數據輸入人員鍵入答案選項的兩個字符,并顯示匹配選項列表。例如,如果我輸入Van,Vanilla就會自動出現。當您有一個包含大量可能的答案選擇的下拉字段時,這非常有用。


**多項選擇-單選按鈕(單選)**
此字段將把您的答案選項顯示為單選按鈕。這意味著所有的答案都可以在屏幕上看到。如果您的潛在答案列表很短,則此選項很好。


**多項選擇復選框(多項答案)**
此字段將以復選框的形式顯示您的答案選擇,并允許多個答案。
注:注明“**勾選所有適用項**”的字段注釋。


**多項選擇題的編碼建議**
**A. 未知值或缺少值**
表示未知類型值的代碼響應,其數字明顯超出任何有意義或丟失的變量代碼或文本響應的正常范圍。
> **這個星期病人每天都測血糖嗎?**
> 1,是的
> 0,不是
> 7777,不知道
> 8888,拒絕回答
> 9999,缺失值
**B. 反向編碼**
如果問題有反向評分,則根據值對選擇進行編碼,除非另有說明。下面是一個示例,其中**4**是正常編碼,而**5**是相反的:
> **4. 讓我需要有人重新自我定位。**
> ????????0,對我來說永遠不是真的
> ????????1,對我來說很少是真的
> ????????2,有時對我來說是真的
> ????????3,對我來說經常是這樣
> ????????4,對我來說經常是這樣
> **5.幫助我鍛煉肌肉。**
> ????????4,對我來說從來不是這樣
> ????????3,對我來說很少是真的
> ????????2,有時對我來說是真的
> ????????1,對我來說經常是這樣
> ????????0,對我來說經常是這樣
**C. 是–否**
此字段將顯示是和否作為單選按鈕回答選項。這些是由redcap預先填充的,不能更改。


> **注意**:是/否問題的默認設置是選擇“**是**”的“1”,選擇“**否**”的“0”。如果項目中有其他包含是或否選項的字段,則希望這些選項保持一致。例如,如果您對選項有疑問是、否,或者,您希望選項標簽是1、0、2,以保持一致。你的統計員會感謝你的!
**D. 真-假**
此字段將顯示True和False作為單選按鈕答案選擇。


#### **14.7 簽名(用鼠標或手指簽名)**
此字段允許參與者使用鼠標或手指(如果使用平板電腦或觸摸屏設備)以數字方式添加其簽名。它有時被稱為數字簽名或電子簽名。


#### **14.8 文件上載(供用戶上載文件)**
此字段使參與者能夠上載文件或圖像


#### **14.9 滑塊視覺模擬刻度**
此字段提供一個包含三個答案選項的刻度。如果您選擇“**顯示數值(0-100)**”,它將對給出的答案進行編碼。


使用此字段類型時,請確保測試數據結果的外觀。即使為標簽設置了數字,這些值也不是為輸入的數據指定的值。所有數據都在1-100的范圍內。
#### **14.10 描述性文本(帶可選圖像/文件附件)**
此字段允許您添加文本,如說明或附加信息。它還提供了將圖像添加為鏈接或內聯圖像的選項。

鏈接:

內聯圖像:

因為描述性文本字段的內容占據了整個水平空間,所以它在頁面上形成了一個很好的分隔符。如果您愿意,可以將其用作“**開始新節**”選項的替代選項。
#### **14.11 開始新節(帶可選文本)**
此字段用作節標題。您可以添加文本或留空。

一般來說,在標題中提供說明性文本是有幫助的。
> **示例**:
> 頭痛殘疾:以下問題試圖評估頭痛對日常活動的影響程度。你的答案應該以過去三個月為基礎。沒有“對”或“錯”的答案,所以請把你的猜測寫下來。
添加“開始新部分”時的注意事項/建議
* 一行中不能有兩個“開始新節”字段類型。
* 不能將“開始新部分”作為儀器的最后一個字段
* 如果矩陣跟隨“開始新節”字段,則REDCap將自動將“開始新節”與矩陣合并。
* 當構建一個包含大量節頭的工具時,首先添加一個虛擬字段,這樣節頭就不是最后一個了
>
> **設計提示 8:當添加“開始新的章節”字段時很有用**
>
> 如果工具是一個調查,并且您希望將調查分成多個頁面,則需要插入“**開始新部分**”,以便REDCap知道在何處結束/開始新頁面。在多個頁面上進行調查有助于分解調查廣告,從而避免參與者必須向下滾動一個長頁面才能提交。
#### **14.12 場矩陣**
如果有一組問題都有相同的答案選擇,則可以創建字段矩陣。不要單擊“添加字段”,而是單擊“添加字段矩陣”。您可以添加一個可選的標題、字段標簽和變量名、指示哪些字段是必需的、添加您的答案選項并選擇這些字段應該是單個答案(單選按鈕)還是多個答案(復選框)。如果希望每個列只選擇一個答案選項,請啟用排名。你還必須給你的矩陣一個組名。



輸入矩陣的配置信息:
* 矩陣標題文本:顯示在矩陣上方的部分標題
* 矩陣行:這些是矩陣中包含的字段
* 矩陣列選擇:矩陣中每個字段共享的響應值和標簽
* 答案格式:單選按鈕或復選框?
* 排名:使用單選按鈕矩陣,您可以選擇排名。排名確保矩陣中的任何兩個字段都不能對列具有相同的選定值。
* 矩陣組名稱:矩陣的唯一引用
您會注意到,通過在線設計器添加矩陣字段時,您看不到添加字段注釋的選項,這與添加常規字段的選項類似。您可以下載項目的數據字典,并將字段注釋添加到G列中,G列是字段注釋的列。
#### **14.13 自定義字段標簽**
簡單的HTML可以在字段標簽中實現。它也可用于澄清或突出顯示信息。示例:text表示下劃線,text表示斜體,text表示紅色并突出顯示采訪者的指示。

要了解有關HTML格式的更多信息,請參閱[此鏈接](https://redcap.vanderbilt.edu/surveys/?s=JLAADYTDJY)。這是一個交互式的在線調查,它使用REDCap中的HTML提供信息。
### **15. 編輯/復制/移動/刪除字段**
編輯:要編輯字段,請單擊鉛筆圖標?
復制:要復制字段,請單擊“雙面打印”圖標
移動:要移動字段,請單擊帶有指針圖標的紙張
刪除:要刪除字段,請單擊紅色的X圖標?

### **16. 停止調查操作**
當儀器作為測量啟用時,字段頂部的工具欄中包含一個附加選項:“測量的停止操作”按鈕,該按鈕顯示為停止標志。此功能允許您根據參與者回答問題的方式阻止他們繼續進行調查。有關如何設置調查停止操作的說明,請參閱本用戶指南的本節。
### **17. 分支邏輯**
分支邏輯用于當您有一個字段/問題,而您只希望在對前一個問題給出特定答案時才可見。
#### **17.1. 添加分支邏輯**
例如,您可能會問以下問題:

你會注意到其中一個選擇是“另一個”。如果有人選擇“另一個”,你可能想問一個后續問題,以了解這另一種冰淇淋口味是什么。但你只希望在上一個問題的答案是“其他”選項時出現后續問題。為此,您將創建后續問題:

然后,在后續問題上,單擊雙綠色箭頭。
現在您將看到這個邏輯生成器:

然后單擊拖放邏輯構建選項并滾動字段選擇列表,直到找到觸發此問題(后續問題)的選項。在本例中,您將選擇“icecream=Other(4)”。然后單擊該選項并將字段拖到右側的框中。完成后單擊“保存”。
字段現在指示分支邏輯存在。

這意味著,只有在輸入數據的人選擇了前一個問題的“其他”答案時,才會出現“如果是其他問題,請指定”的問題。
分支邏輯可以有多個元素。換言之,它可以是對許多不同問題的答案的組合,從而使一個字段出現。
#### **17.2. 測試分支邏輯**
確定分支邏輯有時會很棘手,特別是如果有多個字段參與分支邏輯。這就是為什么測試你的邏輯以確保它按照你想要的方式運行是非常重要的。
若要測試分支邏輯,請添加測試記錄(通過左側導航欄上的“**添加/編輯記錄**”),并查看問題是否按您希望的方式顯示/隱藏。如果在調查中使用分支邏輯,請打開一個調查,查看問題是否按您希望的方式顯示/隱藏,以便將分支邏輯應用于多個問題。如果分支邏輯在項目中的第一個調查上,則可以轉到“調查分發工具”,單擊“打開公共調查”并在其中輸入測試數據。
如果您想將相同的分支邏輯應用于多個問題,那么使用數據字典來完成此任務有時會更容易、更快。使用數據字典可以非常快地將分支邏輯復制并粘貼到多個字段中。
為此,您將:
1. 通過聯機設計器在其中一個字段中創建分支邏輯
2. 轉到數據字典(當您在在線設計器中時,向上滾動到頁面頂部以查看數據字典選項卡)
3. 下載當前數據字典
4. 將數據字典保存在計算機上的某個位置—請務必記下文件的保存位置
請確保數據字典保持.csv格式-不要將其轉換為Excel工作簿!
5. 打開數據字典,找到包含分支邏輯的單元格
6. 復制分支邏輯并將其粘貼到要應用到的其他問題的分支邏輯單元格中
7. 保存數據字典
8. 返回REDCap項目中的數據字典頁
9. 單擊“**選擇文件**”并查找更新的數據字典的文件位置
10. 點擊上傳文件
注意:如果在生產模式下進行這些更改,則需要先進入草稿模式,執行上述步驟,然后單擊“數據字典”頁上的“提交更改以供審閱”。
有關如何使用數據字典的詳細信息,請轉到本用戶指南的[本節]()。
#### **17.3 分支邏輯中變量名的注意事項**
在開發模式下,您確實可以更改變量名。請注意,如果該變量在其他分支邏輯中使用,REDCap不會自動更改分支邏輯中的變量名。
#### **17.4?跨儀器的分支邏輯**
在我們的例子中,在調查1中有一個問題被問到“你有2型糖尿病嗎?”。“這個問題的變量名為type2 diabetes,可能的答案是yes或no。yes的原始值是1,no是0。然后是調查2,問題是“你是否服用治療糖尿病的藥物?”。“變量名是take diabetes meds,答案是yes或no,yes的原始值是1,no是0。
設置分支邏輯,使得只有當被調查者對問題“你否患有2型糖尿病嗎?”的答案是“yes”的時候,問題“您是否服用治療糖尿病的藥物?”才會出現在調查2中。在調查1中…
1. 在在線設計器中,單擊調查2
2. 去現場“你是否服用治療糖尿病的藥物?”
3. 在該字段上,單擊綠色箭頭訪問分支邏輯。
4. 單擊“拖放邏輯生成器”旁邊的按鈕。
這樣做時,您將看到一個下拉框,其中列出了所有工具。
5. 選擇要作為分支邏輯基礎的工具。在我們的示例中,我們希望訪問調查1。
現在您將看到該工具中的所有變量(問題)(在我們的示例中,調查1。)
6. 您可以滾動,直到在列表中看到問題type2diabetes=Yes(1)和type2diabetes=No(0)。
7. 單擊type2 diabetes=Yes(1)并將其拖到右側的框中
8. 單擊“**保存**”
這樣,您對問題“你是否服用治療糖尿病的藥物?”就有了邏輯分支,只有當被調查者對問題“你患有2型糖尿病嗎?”的答案是“yes”的時候,這個問題才會出現在調查2中。
### **18 添加管道邏輯**
管道邏輯使您能夠插入答案并將其放置在REDCap中的不同位置。
例如,在下面的示例中,有一個字段詢問參與者“您喜歡哪種冰淇淋?”接下來是一個詢問參與者“你多久吃一次冰淇淋?”?管道邏輯包含在第二個問題中,以便插入第一個問題的答案。
之前:

一旦參與者回答了第一個問題,答案就會插入到下一個問題中。
之后:

若要添加管道邏輯,請添加要管道輸入的字段的變量名。變量名必須插入方括號[]。
> **注意**:如果要用于管道的變量不相鄰,請考慮在一個選項卡上打開代碼本,在另一個選項卡上進行設計。這樣您就可以很容易地引用代碼本中的變量名。您可以使用ctrl+F功能搜索代碼本。

管道邏輯可用于REDCap中的許多不同位置,例如:
* 現場標簽
* 現場記錄
* 節頭
* 矩陣字段列標題
* 多選字段的選項標簽(單選、下拉、復選框)
* 滑塊字段標簽(即顯示在滑塊上方的文本)
* 調查說明和確認文本
* 通過參與者列表或自動邀請發送的調查邀請電子郵件-在主題行和郵件正文中
#### **18.1 縱向研究項目配置管道的注意事項**
如果您的項目是縱向的,并且希望從不是當前事件的事件導入數據,則需要將適當的唯一事件名稱(也包含在方括號中)預先掛起到變量,例如\[唯一事件名稱\]\[變量名稱\]。通過轉到“**項目設置/定義我的事件**”,可以找到唯一的事件名稱。您將看到一個events表,最后一列顯示由REDCap自動生成的唯一事件名。
#### **18.2 管道教程**
要查看管道的聯機演示,請單擊[此鏈接](https://redcap.vanderbilt.edu/surveys/index.php?s=ph9ZIB).
### **19. 使用HTML和CSS添加樣式**
可以使用帶有CSS樣式的HTML標記將其他樣式添加到項目中的某些元素。
示例:
* 字段標簽
* 章節標題和描述性文本字段
* 調查歡迎和感謝信息
* 調查邀請電子郵件
這本指南不會成為一本網絡編程手冊:你可以在w3schools.com上找到HTML和CSS的參考資料,Google永遠是你的朋友。不過,下面列出了一些可以應用的格式類型示例。首先是一個節標題,然后是兩個字段標簽:

要了解有關HTML格式的更多信息,請參閱[此鏈接](https://redcap.vanderbilt.edu/surveys/?s=u7B74tUTsa?)。這是一個交互式的在線調查,它使用REDCap中的HTML提供信息。
### **20. 共享庫**
REDCap共享庫是一個經過驗證的數據收集工具的存儲庫,可以下載并在REDCap項目中使用。
要訪問REDCap共享庫,項目必須處于開發(而不是生產)模式。您可以通過兩個位置訪問庫:
1. “**項目設置選項卡**”————參閱“**設計數據收集工具**”部分
2. “**在線設計器**”頁面有一個導入按鈕
可以將庫中的任何儀器下載到REDCap項目中。
如果項目處于生產狀態,還可以將創建的數據收集工具上傳到共享庫。然后,世界各地的其他REDCap用戶可以下載它們。
> **注意**:除非您是所有者,否則不要共享受版權保護的材料。
### **21. 智能變量**
#### **21.1 定義**
在REDCap字段表示法中,變量名總是指向項目中的數據字段。但是,另一種類型的實體存在稱為“**智能變量**”,允許您引用數據字段以外的信息。智能變量具有上下文感知功能,因此可以適應許多不同的情況,在這些情況下,智能變量可以知道當前用戶是誰,當前正在查看的事件是什么,工具是否被視為調查或數據輸入表單等。通過這種方式,智能變量是動態的(因此是“智能的”),因為它們適應當前使用它們的上下文。智能變量很容易與字段變量名區分開來,因為智能變量將有破折號和冒號,而字段變量名則不能。
可以使用智能變量的場景
* 他們自己-例如,\[記錄dag名稱\]
* 與字段變量一起使用-例如,\[以前的事件名稱\]\[權重測量\]
* 與其他智能變量結合使用-例如,\[以前的事件名稱\]\[調查:預篩選調查\]
有關智能變量的詳細信息,請參閱[此頁](https://redcap.vanderbilt.edu/redcap\_v9.6.3/Home/index.php)。
## **“項目設置”頁上的步驟3:啟用可選模塊和自定義設置
****
“**項目設置**”頁上的第三個框列出了可以為項目啟用的幾個可選模塊:

### **1. 可重復或重復的儀器**
您可以根據需要動態地重復數據收集工具或單個預定義事件。這是有用的,當收集數據多次訪問,伴隨藥物,不良事件,或重復調查(每周,每月等),不需要預先定義最大的重復次數,并且該特征在經典或縱向項目中工作。
經典項目(即縱向模塊未啟用的項目)可以利用重復儀器作為啟用縱向數據收集的簡單方法。
#### **1.1 啟用可重復儀表**
導航到項目設置,可選模塊。單擊啟用可重復儀表


使用復選框指示哪個數據采集工具可以被重復。

#### **1.2 重復儀器的數據輸入**
在數據輸入過程中,單擊“**保存并添加新實例**”立即創建儀器的另一個實例。

若要在輸入數據后添加儀器的新實例,請單擊數據采集中的+號或在要重復的窗體旁邊的記錄主頁上單擊。只有重復指示器才會顯示+號。

#### **1.3 查看重復儀器狀態圖標**
“**記錄狀態**”儀表板包含一個圖例,指定單個儀表狀態圖標以及儀表重復實例的圖標。單個點表示包含數據的單個儀器。“堆疊”圖標表示儀器的多個實例。

### **2. 記錄的自動編號(在項目設置頁上)**
將自動為項目啟用自動編號,除非您使用的項目模板未啟用自動編號。啟用自動編號后,當您導航到“**添加/編輯記錄**”頁時,將看到以下內容:

此選項將刪除用戶手動命名新記錄的功能,而是自動生成一個新的唯一記錄名稱,該名稱將是數字,并從項目中的最高數字記錄值開始遞增。如果沒有記錄,它將以“1”開頭。
如果要創建自己的記錄標識,可以禁用此功能并手動分配記錄標識。
### **3. 使用1以外的數字開始記錄編號**
使用自動編號時,可以使用以下策略使序列以1以外的數字開頭:
1. 在通過“**項目設置**”頁禁用記錄自動編號的情況下,創建一個標識符小于所需起始編號的偽記錄
2. 在“**項目設置**”頁上啟用記錄自動編號
3. 創建新記錄–這將成為您的第一個記錄
4. 刪除虛擬記錄
例如,如果希望第一條記錄編號為1001,請禁用記錄自動編號,添加id=1000的記錄,啟用記錄自動編號,創建另一條新記錄(將分配id=1001),然后刪除記錄1000。
### **4. 手動分配記錄標識符**
若要手動為項目分配記錄標識符,請轉到“**項目設置**”,然后在“**啟用可選模塊和自定義****設置**”部分中,單擊“**記錄自動編號**”旁邊的“**禁用**”按鈕
現在,當您轉到“**添加/編輯記錄**”時,您將看到以下內容(而不是“**添加記錄**”按鈕):

輸入要用于記錄的標識符,然后按“回車”
**請注意:如果項目中已有記錄或項目中的第一個工具是調查,則“禁用”按鈕將無法單擊。**
### **5. 調度模塊(僅縱向)**
調度模塊可以為項目日歷生成由項目定義的事件(例如,訪問、時間點)自動生成的計劃。調度僅適用于使用縱向數據收集的項目。若要啟用“**計劃**”模塊,需要將項目作為縱向項目啟用(在“**項目設置**”選項卡上的“**步驟**1”下)。然后,可以在“**項目設置**”選項卡的步驟3中單擊“**計劃**”模塊旁邊的“**啟用**”按鈕。有關詳細信息,可以單擊“**項目設置**”頁上模塊旁邊的問號或搜索“**幫助和常見問題解答**”選項卡。
### **6. 隨機化模塊**
隨機化是一個過程,通過偶然(而不是通過選擇)將參與者/受試者分配到特定的組中,通常用于臨床研究和臨床試驗。這被認為是一項高級功能,因此此處不再提供進一步的說明。有關詳細信息,可以單擊“**項目設置**”頁上模塊旁邊的問號或搜索“**幫助和常見問題解答**”選項卡。
### **7. 指定用于發送調查邀請的電子郵件字段**
可用于通過數據輸入表單生成的自動調查邀請或參與者列表。要求項目中必須有一個已驗證為電子郵件字段的字段。
如果您有一個您希望通過公共調查鏈接獲得的調查(例如,您不知道潛在受訪者的電子郵件地址),但希望將后續調查發送給相同的受訪者,這是一個有用的功能。它要求你在第一次調查中要求被調查者的電子郵件地址。然后,當您使用“指定電子郵件字段”模塊時,您將告訴REDCap在初始調查中捕獲的電子郵件地址是您希望后續調查發送到的電子郵件地址。當參與者完成第一次調查時,他們的電子郵件地址將預先填充參與者列表,并允許您發送相同記錄的其他調查。
啟用此功能還可以自動發送調查確認電子郵件(而不是依賴調查參與者在調查完成屏幕上輸入電子郵件地址來接收確認電子郵件)
**注意**:只有在調查答復不是匿名的情況下,才應使用此功能。
有關詳細信息,可以單擊“**項目設置**”頁上模塊旁邊的問號或搜索“**幫助和常見問題解**答”選項卡。
### **8. 項目設置頁上的其他自定義設置**
#### **8.1 設置自定義記錄標簽**
當查看記錄列表(例如,從“**添加/編輯記錄**”或“**記錄狀態**”儀表板上的記錄列表)時,此工具可幫助您識別記錄中包含的內容(通常是記錄所屬人員的姓名)。例如,如果您在項目中收集了人員的姓名,您可以設置一個自定義記錄標簽,以便在記錄標識符旁邊看到此人的姓名。這將通過“**添加/編輯記錄**”和“記錄狀態”儀表板以及表單/調查的頂部可見。這樣,你就不必打開記錄就可以知道它屬于誰。
若要設置自定義記錄標簽,請轉到“**項目設置**”頁,然后在“**啟用可選模塊和自定義設**置”下單擊“**其他自定義設置**”。

您將看到一個添加自定義記錄標簽的選項:

勾選該框,然后將變量名放在希望在記錄標識符旁邊看到的方括號中。在上面的例子中,變量名'fn'捕獲名字,變量名'ln'捕獲姓氏。
所以不要這樣:

而是這樣:

> **設計提示 9:設置自定義記錄標簽時參考代碼本**
>
> 您可能決定在設計項目后的某個時間設置自定義記錄標簽,因此您可能記不起要在記錄標簽中看到的變量的名稱。在這種情況下,您可以檢查代碼簿,看看您給變量起了什么名字。您可以通過左側導航欄上的鏈接(在項目主頁和設計下)訪問代碼簿。
>
> 
#### **8.2 指定輔助唯一字段(在“項目設置”選項卡上的“其他自定義設置”中)**
* 除了主記錄標識符之外的字段,REDCap將確保所有值的唯一性
* 值也將包括在記錄選擇列表中的主記錄標識符旁邊
可以將文本字段指定為唯一約束,該約束的值不能被項目中的任何其他記錄復制或共享。為輔助唯一字段輸入或導入值時,將實時檢查該值,以確保它不被其他記錄共享,如果是,將要求用戶輸入另一個值。這意味著,如果參與者正在完成啟用此功能的第二次調查,他們將看到以下彈出框:

如果是數據輸入表單,用戶將看到:

> **注意**:在開始收集實際數據之前,應該啟用此功能。這是因為如果您已經在收集真實數據,并且項目中存在重復項,則無法啟用此功能。
無法指定兩個或多個字段的組合是唯一的。
#### **8.3 按其他字段排序記錄(在“項目設置”選項卡上的“其他自定義設置”中)**
默認設置是,在數據采集儀器的下拉列表中顯示時,所有記錄都按其記錄名稱(例如,研究ID)排序,但如果需要,也可以按項目中另一個字段(例如,姓氏)的值排序下拉列表。如果要按其他字段對記錄進行排序,可以通過此自定義項選擇要按其排序記錄的字段。
#### **8.4 啟用字段注釋日志或數據解析工作流(數據查詢)(在“項目設置”選項卡上的“其他自定義設置”中)**
字段注釋日志(默認情況下啟用)允許用戶通過單擊字段旁邊的氣球圖標,為數據輸入窗體上的任何給定字段留下注釋。
#### **8.5 PDF自定義(在“項目設置”選項卡上的“其他自定義”中)**
數據輸入表格和調查的可下載PDF可以定制。請參見以下選項:

#### **8.6 為所有數據收集工具啟用“數據歷史記錄”小部件(在“項目設置”選項卡上的“其他自定義設置”中)**
啟用后,數據采集儀器上的每個字段旁邊都會顯示一個圖標。單擊該圖標時,將按時間順序列出為該記錄在該字段中輸入的所有數據的歷史記錄,并顯示以前的所有值、在每個實例中更改該值的用戶以及更改該值的時間。
默認情況下啟用此設置。如果要禁用該功能,請轉到“**項目設置/啟用可選模塊和自定義設置**”,單擊“**其他自定義設置**”并取消勾選該框(需要向下滾動才能看到它):

#### **8.7 不顯示窗體/調查上所有日期和時間字段的“今天/現在”按鈕(在“項目設置”選項卡上的“其他自定義設置”中)**
如果不希望“今天”圖標出現在日期字段旁邊,可以關閉此設置。取消選中“顯示窗體/調查按鈕上所有日期和時間字段的今天/現在按鈕旁邊的框”。

請注意,這是項目級設置。如果希望為項目中的特定字段設置它,可以使用HIDEBUTTON操作標記。有關操作標記的詳細信息,請參閱《用戶指南》的本節。
#### **8.8 在更改現有記錄時需要“原因”嗎?(在“項目設置”選項卡上的其他自定義設置中)**
* 選擇此選項后,用戶每次保存表單時都必須輸入一些文本作為“**更改原因**”-最初創建記錄時除外
* 當對話框出現時,即使在不是第一個表單的表單上輸入新數據(即創建記錄時),用戶也會發現這種對縱向或多表單項目的干擾
#### **8.10 數據輸入觸發器(在“項目設置”選項卡上的其他自定義設置中)**
* 輸入網址,無論何時創建或修改數據輸入表或調查記錄。REDCap將把數據發布到指定的位置。
#### **8.11 數據輸入觸發器說明**
數據輸入觸發器是一項高級功能。它為REDCap觸發對遠程web地址(URL)的調用提供了一種方法,其中,每當在本項目中的\*任何\*數據采集工具或調查上創建或修改\*任何\*記錄或調查響應時,它將向指定的URL發送HTTP?Post請求(它\*不是\*由數據導入觸發,而是僅由調查和數據輸入窗體上的正常數據輸入觸發)。其主要目的是在創建或修改記錄/響應時通知REDCap之外的其他遠程系統,其目的可能是觸發遠程網站的某種操作,例如調用REDCap?API。
> 例如,如果您希望記錄由REDCap之外的遠程系統隨時間修改的記錄的活動,則可以使用此功能來執行此操作。另一個用例可能是,如果您使用API數據導出來保持另一個系統的數據與REDCap項目中的數據同步,在REDCap項目中,數據輸入觸發器將允許您通過通知已觸發的腳本從保存在REDCap中的任何新數據中提取任何新數據來保持它們的完全同步(這可能更為優化和準確而不是頻繁地運行cron作業來從REDCap中提取數據)。
**詳細信息**:在HTTP?Post請求中,REDCap將發送以下參數,以便為剛剛創建/修改的記錄提供上下文:
* project\_id-REDCap項目的唯一id號(即訪問REDCap中的項目時在URL中找到的“pid”值)。
* instrument?-當前數據采集儀器的唯一名稱(項目的所有唯一儀器名稱可在數據字典的B列中找到)。
* record-正在創建或修改的記錄的名稱,它是項目第一個字段的記錄值。
* redcap\_event\_name-修改記錄的事件的唯一事件名稱(僅適用于縱向項目)。
* redcap\_data\_access\_group-記錄所屬的數據訪問組的唯一組名(如果記錄屬于組)。
* \[instrument\]\_complete-此特定數據采集儀器的記錄狀態,其中值為0、1或2。對于數據輸入表單,0=不完整,1=未驗證,2=完整。對于調查,0=部分調查響應,2=完成的調查響應。此參數的名稱將是此特定儀器狀態字段的變量名稱,即儀器的名稱+“\_complete”。
**注意**:如果出于安全原因,記錄的名稱(即第一個字段的值)被視為標識符(如SSN、MRN、name),強烈建議您為數據輸入觸發器提供的URL使用加密連接(即SSL/HTTPS)。
## **“項目設置”頁上的步驟4:設置項目書簽**
因為您的項目是一系列網頁,所以您可以從技術上為其中任何一個網頁添加書簽,并將其顯示在左側的導航菜單上。這將允許您通過單擊進入該頁。因此,如果您發現自己一次又一次地導航到項目的某個特定部分,而該部分還不在左側導航欄上,則可以將其設為書簽,這樣您就可以在一次單擊中找到它。也可以將書簽添加到REDCap之外的任何其他URL。
要在項目中添加頁面的書簽,請執行以下操作:
* 復制要添加書簽的頁面的URL(單擊瀏覽器欄,選擇“**全部**”并復制)
* 右鍵單擊左側導航欄上的“**項目設置**”鏈接并在“**新建**”選項卡中打開鏈接
* 向下滾動到“**設置項目書簽(可選)**”,然后單擊“**添加或編輯書簽**”
* 將URL粘貼到“**鏈接URL/目標框**”
* 在“**鏈接標簽**”框中輸入URL的名稱(例如,聯機設計器或代碼簿)
* 勾選“**打開新窗口**”框
* 點擊“**添加**”按鈕
在項目中創建第一個書簽后,可以轉到導航欄的“**書簽**”部分,然后單擊“**編輯**”按鈕以獲取項目書簽。只有在設置第一個書簽時,才需要轉到“**項目設置**”頁才能訪問書簽。
**筆記**:
* 通過單擊并拖動書簽記錄,可以重新排序書簽
* 將鼠標指針懸停在書簽的鏈接標簽和鏈接URL/目標值上時,將顯示編輯按鈕(一支鉛筆的形狀)
* 使用“刪除”按鈕(紅色的X)刪除書簽
* 連接類型
* REDCap項目:從有權訪問的REDCap項目列表中選擇
* 簡單鏈接:例如外部網頁的簡單URL
* 高級鏈接:與簡單鏈接一樣,指向外部網頁的URL,但REDCap會向目標網站發送附加信息(例如用戶和項目信息),以驗證REDCap用戶在該外部網站上的身份
**用戶訪問**:控制當前項目的哪些用戶可以看到書簽。選擇所有用戶或通過選擇所選用戶單獨選擇特定用戶
## **“項目設置”頁上的步驟5:用戶權限和權限**
### **1. 用戶權限**
總之,用戶權限頁使您能夠:
* 為其他redcap用戶添加和刪除對項目的訪問權限
* 控制每個用戶可以為您的項目訪問哪些應用程序
* 控制允許每個用戶執行的記錄操作
* 創建記錄
* 重命名記錄(即編輯記錄id)
* 刪除記錄
* 控制每個用戶對每個特定數據收集表單的訪問級別
* 禁止進入
* 只讀訪問
* 完全編輯訪問
* 定義角色-權限模板-用戶可以被分配到
### **2. 數據訪問組**
數據訪問組是一個任意的實體,可以認為它類似于研究站點。單個用戶可以分配給單個數據訪問組,項目記錄也可以。用戶創建的組記錄將自動分配給該組。數據訪問組中的用戶只能訪問也分配給該數據訪問組的記錄。
例如,您作為項目所有者創建了一個名為“Nashville?Site”的數據訪問組。你的另一個機構的合作者有一個由REDCap管理員為他們創建的Vanderbilt/Meharry?REDCap帳戶,你將她的用戶名分配給Nashville站點組。合作者可以查看她創建的或您分配給Nashville站點的記錄,但不能查看分配給其他組或未分配給任何組的任何記錄。
有關數據訪問組設置的詳細信息,請參閱本用戶指南“應用程序”部分下的“創建數據訪問組”。
### **3. 向項目中添加用戶(向項目中添加用戶)**
如果要授予其他用戶對項目的訪問權限,請單擊“項目設置”頁或左側導航欄上的“用戶權限”。

您將在工作區(左側導航欄右側的區域)中看到此圖像:

在“**添加新用戶**”字段中輸入此人的Net ID或外部用戶名。(請參閱[此處]()以獲取中心以外同事的外部用戶帳戶)
* 如果找到此人,請單擊其姓名,然后單擊“**添加自定義權限**”。
* 如果找不到此人,這意味著他們無法訪問REDCap,或者之前沒有登錄REDCap。如果他們是中心員工,可以通過輸入他們的Net?ID將他們添加到項目中。不能通過他們的電子郵件地址添加他們。
正確方法:wcteachout
錯誤方式:wcteachout@xjtu.edu.cn
單擊“**添加自定義權限**”后,您現在將看到類似于以下內容的屏幕:

選擇您希望用戶訪問的內容。選擇適當的權限,然后單擊“**添加用戶**”。
### **4. 自定義用戶權限**
基本用戶權限部分是用戶可以訪問的REDCap模塊的清單。
一般來說,應該只允許用戶訪問他們需要的模塊,而不是更多。這就是所謂的[最低特權原則](http://en.wikipedia.org/wiki/Principle\_of\_least\_privilege),它既可以提高項目的安全性,又可以通過從用戶視圖中移除不必要的混亂來幫助可用性。
注意,Project?Expiration?Date字段為您提供了在特定時間段內允許訪問的選項。請注意:這與外部用戶的帳戶到期日期不同。
數據輸入權限允許您限制用戶可以訪問哪些工具以及如何編輯數據。如果項目已啟用調查,則將有一個列用于編輯調查答復。只有數據輸入表單的項目將沒有該列。[最低特權原則](http://en.wikipedia.org/wiki/Principle\_of\_least\_privilege)在這里也適用。
頁面底部有三個按鈕:
* 保存更改
* 取消
* 刪除用戶:從項目中刪除用戶
有關訪問REDCap安裝的更多問題,請參閱我們的REDCap用戶頁面的這一部分。
#### **4.1 刪除用戶(刪除用戶)**
要從項目中刪除用戶,請從“**用戶權限**”列表中選擇其名稱,然后單擊“**編輯用戶權限**”。你可以點擊“**刪除用戶**”按鈕。
請注意,如果要從項目中刪除某個用戶,并且該用戶已分配給某個角色,則必須先將其從該角色中刪除,然后將其作為用戶刪除。
刪除用戶的另一種方法是,通過在用戶權限的“**過期日期**”字段中輸入他們應有權訪問項目的最后日期,使他們作為用戶過期。
### **5. 用戶角色**
角色只是用戶權限的模板。分配給角色的用戶被授予該角色配置為具有的一組權限。
#### **5.1 創建角色**
您可以命名和定義項目級用戶角色(例如,數據管理器、數據輸入、項目管理器等),然后將用戶分配給適當的角色。此功能允許您根據用戶在項目中的特定角色快速、一致地指定用戶權限。
創建角色類似于創建具有自定義權限的用戶:輸入角色的名稱(如“**項目經理**”、“**數據輸入**”等),然后單擊“**創建角色**”。

配置與角色關聯的權限,然后單擊“**創建角色**”。
#### **5.2 向角色添加新用戶**
在“**分配新用戶**”文本框中輸入用戶名或用戶名,單擊“**分配給角色**”,然后選擇應分配給該用戶的角色。

#### **5.3 更改用戶的角色**
通過單擊用戶的名稱,然后單擊“**分配給角色**”,然后選擇角色,可以更改用戶的角色(或將未分配的用戶分配給角色)。

## **項目設置頁面上的步驟6:徹底測試項目**
在將項目投入生產之前測試它是非常重要的!
### **1. 試驗目的**
數據庫的目的——以及數據庫軟件的功能——是為您的數據提供結構和完整性,而這些結構和完整性是不能使用非結構化格式(如文本文件或電子表格)強制實現的。
測試數據庫的目的是確保它具有預期的結構和完整性檢查,并且滿足您的要求。
### **2. 添加測試數據**
嘗試創建一些測試記錄并輸入一些數據,以確保數據收集工具的外觀和行為符合預期,特別是分支邏輯和計算。您可以通過單擊左側導航欄上的“**添加/編輯記錄**”來完成此操作。
如果未啟用自動編號,則將為新記錄輸入唯一的:

如果啟用了自動編號功能,則可以單擊“**添加記錄**”:

在數據輸入表單中輸入測試數據。
### **3. 為調查添加測試數據**
如果您有調查,請使用“**公共調查**”鏈接完成調查,就像您是參與者一樣。要訪問“**公共調查**”鏈接,請單擊左側導航欄上的“**調查分發工具**”鏈接,然后打開“**公共調查**”:

* 如果您沒有看到“**公共調查**”鏈接,則表示您沒有啟用第一個工具作為調查,或者您沒有將項目設置為包含調查。在“**項目設置**”頁上列出的第一步中,可以在項目中啟用調查。您可以在聯機設計器頁上啟用儀器作為調查。(通過單擊左側導航欄上“**項目主頁和設計**”下的“**設計器**”按鈕,可以訪問聯機設計器)
* 輸入測試數據時要檢查的特定內容
* 對于連續的字段,例如日期和數字,具有范圍驗證,通過輸入最小值和最大值(應該成功)來測試邊界周圍的值,然后在有效范圍之外輸入值(這應該觸發警告)。例如,如果高度應為50-250厘米:請確保接受50和250,并確保49和251觸發警告消息。
* 測試你的分支邏輯是否正常工作,例如,跳過男性參與者的懷孕問題。
* 檢查所需字段是否標記為所需字段。
* 輸入了一些測試記錄后,請轉到記錄狀態儀表板查看它們;創建報告并導出數據,然后在Excel或某個統計分析包中查看;查看統計信息。
測試項目的最佳方法是將其用作輸入真實的生產數據,讓同事(特別是團隊成員)查看項目以獲得新的關注總是很有幫助的。
**設計提示 10:測試參與者將要輸入數據的設備類型**
與普通計算機上的數據輸入相比,設計用于手機或平板電腦的數據輸入表單不需要太多特殊考慮。最重要的是使用將在現場使用的設備來測試表單。這樣你就可以確定任何你想改變的地方。
值得考慮的一件事是使用下拉列表而不是文本字段來輸入數字。即使是一個很長的下拉列表(比如一個重量列表,可能有20.0公斤到50.0公斤,增量為100克:31個條目),對于平板電腦用戶來說,也可能比使用移動鍵盤的文本框更容易。
### **4. 為項目開發和測試留出充足的時間**
我們的REDCap團隊不僅負責支持自己的最終用戶,還負責支持世界各地的其他REDCap管理團隊,并不斷改進軟件。因此,我們希望盡可能地支持我們的最終用戶,但我們確實對我們能夠提供的支持的即時性和類型有限制。幫助我們為您提供充足的測試和部署時間。如果您的項目在需要啟動時有一個截止日期,請確保至少提前兩周開始測試。如果你有任何問題,這將給你時間尋求我們的幫助。
## **“項目設置”頁上的步驟7:將項目移動到生產環境**
創建項目時,其默認狀態為開發模式,并且立即部署任何更改,覆蓋或刪除任何現有數據。這很好,因為您在開發模式下輸入的任何數據都應該只是測試數據,因此如果該數據已損壞或刪除,則可以。但是,一旦開始收集實際數據,則始終建議項目處于生產狀態。
將項目轉移到生產狀態有三件重要的事情:
* 它表明數據是真實而重要的
* 它使數據在數據丟失時可以恢復
* 它創建數據字典的快照,以便在需要添加或編輯數據庫時,對數據至關重要的任何更改都將保留,直到REDCap有機會查看更改的影響
強烈建議您在將項目投入生產之前徹底測試項目。
### **1. 如何將項目移到生產模式**
確保項目捕獲了所需的所有字段并具有所需的所有設計元素后,單擊“將項目移動到生產”圖標。

只需單擊一下,您就可以選擇刪除所有輸入的測試數據。如果在生產之后輸入測試數據,則必須手動刪除每個單獨的記錄。
### **2. 檢查標識符**
還要注意檢查標識符步驟。建議您執行標識符檢查,以確保包含參與者標識符的所有字段(或可能包含可能用于標識參與者的任何信息)都標記為標識字段。這有助于保護機密數據不被不允許查看的用戶訪問。
一旦投入生產,您仍然可以對項目設計進行更改,這只需要幾個額外的步驟。您可以在草稿模式下進行編輯,然后需要由REDCap管理員批準才能生效。很多時候,這些更改會在幾秒鐘內自動獲得批準。
### **3. 處于生產模式的優勢**
如果在生產過程中對項目進行任何設計更改,則ReDCAP將檢查以確保這些更改不會損壞/刪除現有數據。
### **4. 在生產中進行設計更改**
當項目處于生產模式時,任何設計更改都要求將項目狀態更改為草稿模式。訪問聯機設計器時,REDCap將提示您進入草稿模式。
一旦進入草稿模式,就可以更改指示器的設計。然后,您需要提交更改以供審閱。在提交變更之前,我們鼓勵您使用“**查看所有草擬變更的詳細摘要**”來清楚地了解變更的影響。

REDCap將自動批準您對所有非關鍵生產后更改所做的更改。
可能導致數據損壞和/或丟失的更改將需要您的書面批準。REDCap會自動向您發送一封電子郵件,要求您確認您確實希望進行更改。在您回復電子郵件之前,更改不會生效。
### **5. 項目狀態更改**
項目投入生產后,項目狀態將在左側導航菜單上指示生產。類似地,當您在“我的項目”頁面上時,您會注意到項目名稱旁邊的圖標已從扳手(用于開發)更改為帶有復選標記(用于生產)的綠色框。

**譯者:西安交通大學公共衛生學院 徐坤**
**審校:米白冰**