<!DOCTYPE TEI.2 SYSTEM "C:\xml\shared\teilite\teixlite.dtd" [
  <!ENTITY figure1 SYSTEM "http://www.iath.virginia.edu/~jmu2m/cse/CSE.gif" NDATA JPEG>
  <!ENTITY figure2 SYSTEM "http://www.iath.virginia.edu/~jmu2m/cse/cse.voting.edited.jpg" NDATA JPEG>
  <!ENTITY figure3 SYSTEM "http://www.iath.virginia.edu/~jmu2m/cse/supporting.jedited.pg" NDATA JPEG>
  <!ENTITY figure4 SYSTEM "http://www.iath.virginia.edu/~jmu2m/cse/current.votes.edited.jpg" NDATA JPEG>
  <!ENTITY figure5 SYSTEM "http://www.iath.virginia.edu/~jmu2m/cse/new.vote.edited.jpg" NDATA JPEG>
  <!ENTITY link SYSTEM "http://www.iath.virginia.edu/~jmu2m/cse/" NDATA HTML>
]>
<TEI.2> 
  <TEIHEADER> 
	 <FILEDESC> 
		<TITLESTMT> 
		  <TITLE>CSE Database</TITLE> 
		</TITLESTMT> 
		<PUBLICATIONSTMT> 
		  <PUBLISHER>IATH</PUBLISHER> 
		  <PUBPLACE>University of Virginia</PUBPLACE> 
		  <DATE>&copy; 2002</DATE> 
		</PUBLICATIONSTMT> 
		<SOURCEDESC> 
		  <P>Original</P> 
		</SOURCEDESC> 
	 </FILEDESC> 
  </TEIHEADER> 
  <TEXT> 
	 <FRONT> 
		<DOCTITLE> 
		  <TITLEPART>CSE Database</TITLEPART> 
		</DOCTITLE> 
		<DOCAUTHOR>Sarah Wells</DOCAUTHOR> 
	 </FRONT> 
	 <BODY> 
		<DIV0> 
		  <HEAD N="top" ID="top">CSE database</HEAD> 
		  <P>The CSE database is a web-based interface for tracking and rating
			 submissions to the Modern Language Association&rsquo;s Committee of Scholarly
			 Editions (CSE). The database contains the names of committee members and
			 reviewers associated with this process and the editions which are under
			 consideration for approval, or have been approved in the past (back to 2002).
			 </P> 
		  <DIV1> 
			 <HEAD ID="level1" N="1">Getting into the database</HEAD> 
			 <DIV2> 
				<HEAD ID="level1.1" N="1.1">Logging in</HEAD> 
				<P>Users (who must be members of the CSE) start at the login page,
				  currently linked from 
				  <XREF TARGTYPE="html"
					DOC="link">http://www.iath.virginia.edu/~jmu2m/cse/</XREF>, and must enter a
				  login name and password. There are different levels of permissions for
				  committee members and committee chairs. Specific instructions below are labeled
				  &ldquo;All&rdquo; or &ldquo;Chairs&rdquo;, depending on whether they apply to
				  all members/users or only to the chairs.</P> 
			 </DIV2> 
			 <DIV2> 
				<HEAD ID="level1.2" N="1.2">Logging out</HEAD> 
				<P>To log out, click Logout in the left-hand frame. This will
				  return you to the login window.</P> 
			 </DIV2> 
		  </DIV1> 
		  <DIV1> 
			 <HEAD ID="level2" N="2">Using the database (All)</HEAD> 
			 <P>After logging in, you will be taken to the database homepage
				(below). The left column contains a pull-down list of the entities (or tables)
				in the CSE database (described below) and links for searching and adding
				entries. You can carry out many of these same tasks from the right side of the
				window, which may seem confusing at first. 
				<FIGURE ID="figure1" ENTITY="figure1" N="1"> 
				  <FIGDESC>CSE database home page</FIGDESC> 
				</FIGURE></P> 
			 <P>To look at a list of all of the items in an &ldquo;entity&rdquo;,
				you can either go to the home page and click the magnifying glass icon for that
				entity on the far right-hand side of the page, or select the entity in the
				pull-down list on the left, click &ldquo;Search&rdquo; below the pull-down
				list, and then click the &ldquo;Search DB&rdquo; button at the bottom of the
				search form that appears on the right-hand side of the page. The former method
				is simpler, and is therefore recommended. </P> 
			 <DIV2> 
				<HEAD ID="level2.1" N="2.1">Searching (All)</HEAD> 
				<P>If you want to look at only selected items, there are two ways
				  to search/select for them. 
				  <LIST TYPE="numbered"> 
					 <ITEM>Go to the home page. On the right-hand side of the page
						(not in the blue left-hand column) select the appropriate parameter from the
						pull-down list next to the entity you want to search, enter a search term in
						the empty text box, and then click the magnifying glass icon to the right of
						that entity.</ITEM> 
					 <ITEM>Select an entity from the pull-down list in the left
						column and click the Search button. Using the resulting search form, you have
						somewhat greater control over the parameters of the search and the conditions
						under which an item will match your term. </ITEM> 
				  </LIST> </P> 
				<P>There are six possible relational operators that will often
				  appear in the tables to use in searching the database: =, &lt;&gt;, &lt;, &gt;,
				  &lt;=, and &gt;=. These are awkward for using with string searches, so we
				  suggest that you stick to the equal sign unless searching a date field. </P> 
				<P>The search options are different for each entity. If you search
				  &ldquo;Edition,&rdquo; for example, you will see Edition-related fields. If you
				  search &ldquo;Reviewer,&rdquo; you will see Reviewer-related fields. </P> 
				<P>If you don&rsquo;t specify a search term, you will see every
				  item in that entity or table.</P> 
			 </DIV2> 
			 <DIV2> 
				<HEAD ID="level2.2" N="2.2">Adding new entries (Chairs)</HEAD> 
				<P>The CSE database is a relational database. This means, for
				  example, that records concerning an editor are maintained separately from
				  records concerning an edition, and the two records are related. Databases are
				  designed this way so that there can be one record for an editor who may be
				  related to multiple edition-records, instead of keeping (and having to update)
				  multiple copies of the information concerning that editor. This also means that
				  these related records need to be separately created, and dependent records will
				  need to be created before the records on which they depend&mdash;for example,
				  if the editor of an edition under review is new, and the edition is new, the
				  records for the editor and the edition will need to be created before they can
				  be associated with a newly created record for the review. Similary, before
				  adding a new series, the records for the editions encompassed by the series
				  must be added.</P> 
				<P>Only a CSE chair can add new entries to the database. To add new
				  information, select the appropriate entity from the pull-down list in the left
				  corner then click &ldquo;New.&rdquo; As with &ldquo;Search&rdquo; you will only
				  see the relevant fields. When you are finished, click &ldquo;Save.&rdquo; To
				  cancel the changes, click &ldquo;Cancel.&rdquo; To delete an entry, click
				  &ldquo;Delete.&rdquo; </P> 
			 </DIV2> 
			 <DIV2> 
				<HEAD ID="level2.3" N="2.3">Voting (All)</HEAD> 
				<P>If the Chairs have designated a review as being ready for a
				  vote, the review will be presented to each member who logs in, until that
				  member has voted. The vote screen looks like this:
				  <FIGURE ID="figure2" ENTITY="figure2" N="2"> 
					 <FIGDESC>CSE voting window</FIGDESC> 
				  </FIGURE></P> 
				<P>When, upon logging in, you are presented with a review to vote
				  on, you can 
				  <LIST TYPE="numbered">
					 <ITEM>examine the supporting material, or</ITEM>
					 <ITEM>vote on the review</ITEM>
				  </LIST>To examine supporting materials, click on each link for a
				  supporting document, and you will see a screen that looks like this:
				  <FIGURE ID="figure3" ENTITY="figure3" N="3"> 
					 <FIGDESC>Inspecting supplementary materials</FIGDESC> 
				  </FIGURE></P>
				<P> Click on the link next to "View" and you'll get a readable copy
				  of the material. Materials are either PDF files or Microsoft Word document, so
				  you'll need a PDF reader and/or Word installed on your system to read them.
				  Once you're done reading, click "Return" and you will go back to the voting
				  screen. From there, as before, you can either examine further supporting
				  material, or vote.</P>
				<P>To vote, click on the hand icon next to the &ldquo;Votes&rdquo;
				  box on the review screen: this will take you to a screen that shows you who has
				  already voted on this review, and allows you to record a new vote (yours) by
				  choosing "New":
				  <FIGURE ID="figure4" ENTITY="figure4" N="4"> 
					 <FIGDESC>Current votes</FIGDESC> 
				  </FIGURE></P>
				<P>The new vote screen looks like this:
				  <FIGURE ID="figure5" ENTITY="figure5" N="5"> 
					 <FIGDESC>New vote screen</FIGDESC> 
				  </FIGURE></P>
				<P> On this screen, 
				  <LIST TYPE="numbered">
					 <ITEM>You can rate the review itself (on a scale of 1-5, with 1
						best, 5 worst), </ITEM>
					 <ITEM> recommend the reviewer for future Committee
						membership,</ITEM>
					 <ITEM> recommend the reviewer for future reviews, </ITEM>
					 <ITEM>and vote to award or withhold the CSE&rsquo;s seal, or
						abstain. </ITEM>
				  </LIST> </P>
				<P>After having made your choices, click &ldquo;Save&rdquo; to
				  record the vote, and then click &ldquo;Return&rdquo; on the next screen, to go
				  back to the original vote form. <HI REND="italics">From here, you must click
				  &ldquo;Save&rdquo;at the bottom of the form in order to finally register the
				  vote.</HI> Remember, after voting, you click through three screens, choosing
				  <HI REND="italics">Save, Return, Save</HI>, in order to finally register your
				  vote. If you forget one of these steps, you will be prompted, once again, to
				  vote on this review, next time you log in.</P>
			 </DIV2> 
			 <DIV2> 
				<HEAD ID="level2.4" N="2.4">Uploading supporting materials
				  (Chairs)</HEAD> 
				<P>To upload supporting materials (normally Word documents or PDF
				  files), choose &ldquo;Supporting Material&rdquo; from the pull-down on the
				  left-hand side of the main page. Then click &ldquo;New&rdquo; below the
				  pull-down list. On the right-hand side of the page, choose &ldquo;Browse&rdquo;
				  and locate on your local file-system the file you intend to upload. Having done
				  so, click &ldquo;Save.&rdquo; </P> 
				<P>Now, on the left-hand side of the page, choose
				  &ldquo;Review&rdquo; from the pull-down list, and click &ldquo;Search.&rdquo;
				  On the right-hand side, click &ldquo;Search DB&rdquo; to list all reviews
				  currently in the system (if the review has not already been created, it will
				  have to be added before supporting materials can be associated with it). Click
				  the hand icon to the left of the appropriate review, then click the hand icon
				  to the right of the &ldquo;supporting materials&rdquo; section of the review
				  form. At the bottom of the right-hand side of the page, click the &ldquo;Search
				  DB&rdquo; button to list all supporting materials in the system. Click
				  &ldquo;select&rdquo; next to the appropriate supporting document, then click
				  &ldquo;Return&rdquo; when the screen refreshes, then click &ldquo;Save&rdquo;
				  on the next screen, to finalize the association between this upload and the
				  review in question. </P> 
			 </DIV2> 
		  </DIV1> 
		  <DIV1> 
			 <HEAD ID="level3" N="3">The entities (Chairs)</HEAD> 
			 <P>There are nine entities, all of which refer to tables in the
				database. Note that the hand icon always indicates that an entry in a table can
				be edited. Click the icon to see the complete entry and to edit it.</P> 
			 <DIV2> 
				<HEAD ID="level3.1" N="3.1">Chair table</HEAD> 
				<P>This contains the names of the CSE chairs and contact
				  information. Only chairs can edit the lists of reviewers, editors, and review
				  materials, as well as solicit, assign, and manage reviewers. They can also read
				  reviews, rate editions on a scale of 1 to 5, submit editions for review, and
				  vote on whether to give an edition a seal of approval or not.</P> 
			 </DIV2> 
			 <DIV2> 
				<HEAD ID="level3.2" N="3.2">Edition table</HEAD> 
				<P>The Edition category is a list of editions which are being
				  reviewed or have been submitted for review by committee members. It contains
				  the name of the edition and editor(s), reviewer notes, and (if the edition is
				  electronic) the edition&rsquo;s URL (note that the database does not copy the
				  work to the server from this window). </P> 
			 </DIV2> 
			 <DIV2> 
				<HEAD ID="level3.3" N="3.3">Editor table</HEAD> 
				<P>This is a list of the editors of the editions currently in the
				  CSE database and their contact information. This includes editors whose work
				  has already been reviewed and voted on. </P> 
			 </DIV2> 
			 <DIV2> 
				<HEAD ID="level3.4" N="3.4">Member table</HEAD> 
				<P>This is a list of committee members and their contact
				  information. Committee members can read reviews, rate editions on a scale of 1
				  to 5, submit editions for review, and vote on whether to give an edition a seal
				  of approval or not. </P> 
			 </DIV2> 
			 <DIV2> 
				<HEAD ID="level3.5" N="3.5">Review table</HEAD> 
				<P>This category contains information about reviews. This includes
				  those reviews that have already been submitted and those that are still in
				  progress. Each review has a review manager, which is one of the committee
				  chairs. Reviews are not submitted to the database.</P> 
				<P>The Review category has a start and end date for each edition.
				  This refers to when the review was assigned to a particular reviewer and when
				  it was completed.</P> 
			 </DIV2> 
			 <DIV2> 
				<HEAD ID="level3.6" N="3.6">Reviewer table</HEAD> 
				<P>This is a list of currently active reviewers. These are not
				  committee members but scholars recruited by member to review selected editions.
				  Reviewers can submit reviews and read supporting materials.</P> 
			 </DIV2> 
			 <DIV2> 
				<HEAD ID="level3.7" N="3.7">Series table</HEAD> 
				<P>A series is a collection of editions (all of which must be
				  entered in the Editions table). The table contains series which are being
				  reviewed or have been submitted for review by committee members. It contains
				  the series' title and editions, its editor(s), reviewer notes, and (if
				  appropriate) URLs for the editions.</P> 
			 </DIV2> 
			 <DIV2> 
				<HEAD ID="level3.8" N="3.8">Supporting Material table</HEAD> 
				<P>This contains materials supporting a review, such as the review
				  itself, and filenames and pointers to documents and web sites that supplement,
				  support, and otherwise add to editions in the database (note that the database
				  does not copy the work to the server from this window).</P> 
			 </DIV2> 
			 <DIV2> 
				<HEAD ID="level3.9" N="3.9">Vote table</HEAD> 
				<P>This is a list of votes that have been cast by committee
				  members. Votes range from a scale of 1 (best) to 5 (worst). Members can also
				  recommend reviewer membership in the committee, review of proposed editions,
				  vote for or against the committee&rsquo;s seal of approval, or abstain. </P> 
			 </DIV2> 
		  </DIV1> 
		</DIV0> 
	 </BODY> 
  </TEXT> 
</TEI.2> 
