advanced [EgoWeb 2.0 wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
======Advanced Features======
===== Create Longitudinal Studies=====
EgoWeb 2.0 allows you to create and administer longitudinal studies—referred to as multi-session studies in EgoWeb 2.0. This section describes how to create a multi-session study in EgoWeb 2.0.\\ \\  The first step is to create a separate single-session study for each session that you want to include in the multi-session study (baseline, first follow-up, second follow-up, etc.). In each single-session study, you will program in the questions you want to ask.

//NOTE:// In earlier versions of EgoWeb, each question in a multi-session study needed unique names. This is no longer true. Questions in multi-session studies can now have the same name. EgoWeb 2.0 now references variables in expressions, etc. by the study name + the variable name, so re-using the variable name across linked multi-session studies is no longer a problem. Just be sure to name your study files differently to make sure you can identify them.)\\ \\ The second step in creating a multi-session study is to link the single-session studies together. In the “Ego ID Question” section of each study, create a question asking for the respondent’s Ego ID, and give this question the same name across the different studies. This name should be unique to your multi-session study to ensure that EgoWeb 2.0 will link together the right set of studies. In the screenshot below, this Ego ID question has the name “SRHT_ID_BF” at the baseline study. The Ego ID question in all subsequent studies that are part of this multi-session study should therefore also be named “SRHT_ID_BF.”

| {{{ ::advanced_multi-session_create_egoid_var.png |}} |
| Creating a linking variable in the EgoID screen |

After creating your Ego ID question for each of the studies you want to link together, go into the study settings for each study and select this question in the multi-session drop-down menu. This will link the studies together into one multi-session study. See the screen shot below.\\ \\  
//NOTE:// Even if you only have one study, it will show up as a multi-session study as soon as you set the Multi-session variable. 

| {{ ::advanced_multi-session_link_egoid_var.png |}} |
| Choosing the linking variable for multi-session studies |

Once you’ve linked your studies together, you can create expressions in one study based on answers from another study in the multi-session study. So, for example, if you have a question called "gender" in your baseline instrument (called "Baseline_Study"), if you want to create an expression at the next interview study (called "Followup_Study) so that the gender question will be skipped if it was already answered by that respondent during the "Baseline_Study" interview, you can go to the expressions section of the first follow-up study and create an expression by selecting the question "Baseline_Study: gender" from the dropdown menu.\\ \\  When interviewing, if the EgoID variable entered has been used in another study session, the data will be linked in the new interview.
 
=====Web-based Studies with Invited Participants=====
//NOTE:// This feature works for server installations of EgoWeb 2.0. If you have an EgoWeb 2.0 installation URL that starts with "localhost" you have a PC or Mac install and will not be able to send these links to participants.\\ \\  There are currently two ways of starting an interview. First, interviews can be started by logging in to EgoWeb 2.0 and using the “Interviewing” link to start a new interview. This requires a user account to be added to “User Admin”. Users can be categorized as Interviewers and assigned to specific studies. This limits these accounts to only conducting interviews on studies assigned to them. However, this does not work for studies in which you want participants to fill out their own responses and not be added to the EgoWeb 2.0 server as a user.\\ \\  The second way to initiate an EgoWeb 2.0 interview is through creating a study with Pre-Defined Participants. This allows you to invite users to fill out their own responses without having them be assigned EgoWeb users.\\ \\  

Step 1: Add Pre-defined Participants

| {{ ::pre-def_participant.jpg |}} |
| Pre-Defined Participant Entry |

The .csv file with participant names and email addresses must be in the format shown below to be imported correctly. DO NOT import a Microsoft Excel file. Save an Excel file as a .csv format before importing. Do not include column headings.

| {{ ::pre-def_participant_import_csv.jpg |}} |
| Format of .csv file for Pre-defined Participant Importing. |

Step 2: Create EgoID question for capturing authenticated email associated with link. 

| {{ ::egoid_screen.jpg |}} |
| EgoId Screen for linking email to url for Pre-Defined Participant |

Step 3. Generate links for participants. There are two ways to generate links. The first and most time intensive way is to manually click on the link icon to create a link to send to each participant. The second way is to export the entire Pre-Defined Participant data into a .csv file. This file can be used in email programs to send out invitations to a whole list of participants at one time with the associated url. To generate this file, first, click the blue "Export Pre-defined participant List" button within the Pre-defined Participant List setting section.  

//NOTE:// The "Export Pre-defined participant" button used to be in the **Data Processing** section and was recently moved here because it fits better.  The button also previously incorrectly referenced pre-defined "Alters", but now has been correctly renamed to "Participants". For older versions of EgoWeb, see the image below to locate where to export the pre-defined list. 
 
| {{ ::pre-def_participant_export.jpg |}} |
| Export Pre-defined Participant List |

| {{ ::pre-def_participant_export_csv.jpg |}} |
| .csv file with exported pre-defined participant data associated links |

=====Dyad Match=====
Dyad Match provides an interface to do the alter matching [[http://onlinelibrary.wiley.com/doi/10.1111/jomf.12151/abstract;jsessionid=C85E86ED7164DBC016B286E37A640B87.f03t02|described in this paper: The Analysis of Duocentric Social Networks: A Primer]]\\  The interface provides a way to identify if two respondents in two separate EgoWeb 2.0 interviews named the same alters. Matched alters are flagged in the ego-alter data export for analysis in other software.\\ \\  This interface is still in progress. It is going to be used [[https://projectreporter.nih.gov/project_info_description.cfm?aid=9066504&icde=33690471&ddparam=&ddvalue=&ddsub=&cr=1&csb=default&cs=ASC&pball=|for a new study of low income newlywed couples]]. Most of the programming has been completed but it is still being tested. Check back later for more detailed instructions.
~~DISCUSSION~~