MyGradeBook Help Menu
General District Integration Information

Automated Comment Downloading
Before you can download the comments, your group or your Master Group must use the main integration page to specify an IP Address that will be used when downloading files. Finally, you must have software that allows you to mimic an https post to

https://www.mygradebook.com/secured/group_auto_comment_download.cfm?RequestTimeout=1800

**Note** Do not use a different value for the RequestTimeout parameter. If your post is successful, MyGradeBook will respond to your post with text in a tab or csv format based on the option you specified when you posted.

**Note** Each Official Comment is recorded with the start date and end date of a specific class grading period. For classes that do not use grading periods, Official Comments are recorded with the start date and end date of the class itself. Files that are generated by Automated Comment Downloading include all comments that match the entries in both the START_DATE and END_DATE fields.
Form fields to use when posting to group_auto_comment_download.cfm are described below.
GROUP_ID Required. ID of group the file is for.
PWORD Only supply this if NOT posting for a sub group. Should be password for the group specified by GROUP_ID.
MASTER_GROUP_ID Should only be present if posting for a sub group.
MASTER_GROUP_PASSWORD Should only be present if posting for a sub group.
EMAIL Required. This is not necessarily the group manager's email address. This email address is sent information when a problem is encountered while trying to accept the silent post.

For security reasons, if the authentication information is incorrect, this parameter is ignored, and only the group manager (or master group manager, if given) is emailed.
DESCRIPTION Required. This field allows the caller to better understand the feedback when problems occur. This value is used in response emails and should contain descriptive text for the marks you are downloading. A typical value might be "Semester 1 Comments"
EXPORT_FORMAT Optional. Default is ".txt". If supplied, this field should contain either ".csv" (comma separate values) or ".txt" (tab separated values).
EXPORT_FLAG Optional. Default is "C". This field lets you enter a text value that will be put into the first column of each row. Some districts put a value in this field to help their system determine what type of information the file contains. Maximum length is 20 characters.
START_DATE Required. Use this field to indicate the start date of the grading period and/or classes for which you want to export comments. The format of the date you post should be based on the date format that is used by the country you are in. The My Account screen lets you indicate which country you are in.
END_DATE Required. Use this field to indicate the end date of the grading period and/or classes for which you want to export comments. The format of the date you post should be based on the date format that is used by the country you are in. The My Account screen lets you indicate which country you are in.


Response Format
If your post was invalid, the system will respond with "500 - " followed by an error message. If you successfully post a request, a https response is returned that contains the following columns:

Export Flag - This column contains the value you specified in the EXPORT_FLAG field when you submitted your post.

School ID - This column is based on the text you put in the School ID field in the Integration Information screen.

Group ID - This column contains the value you specified in the GROUP_ID field when you submitted your post.

Course DID - This column contains the Course District Identifier assigned to the class.

Section Code - This column contains the Section Code assigned to the class.

Student DID - This column contains the Student District Identifier.

Comment Date - End date of the grading period or class for which the comment was recorded.

Comment Code - This column contains the comment code recorded for the student in the course/section on the specified date.

Date Run - This column contains the date the file was created in YYYYMMDD format.


Privacy | Terms of Use | Link To Us | Help | Contact Us
© 1999 - 2014 KMKVGK Inc. All rights reserved
Ver 11.66 - GB - Page generated in 0 seconds