Skip to content

Users Guide

AMY: The Carpentries' internal database

Logging in

  • Log in to AMY here. Administrative users may log in via GitHub or a user id. Instructors should log in via GitHub. Contact The Carpentries Core Team if you have difficulty logging in.

AMY login screen goes here

AMY Dashboard

All menus and a search bar are displayed across the top. The main page has two columns, showing current workshops and in progress workshops. This view can be filtered to show workshops assigned to the logged in administrator, another administrator, or unassigned workshops.

AMY dashboard

  • Current workshops have a complete start and end date, a valid url, and a complete location.
  • In progress workshops are all workshops that do not meet these criteria.

Current Data, Library, and Software Carpentry workshops will be listed on The Carpentries website, the corresponding lesson program website, and The Carpentries data feeds if the box to publish the workshop is checked. Instructor Training events are not publicly listed.

From here you can also add new events, organisations, persons, or airports to the database.

AMY add new elements

Adding a New Organisation

If an organisation is not already in AMY, add a new one by selecting "New Organisation." Domain and Full Name are required fields. Enter in the domain (full website, such as https://www.example.com/library). When known, enter in the country and latitude/longitude of the main location. There is also a text box for open ended comments.

The "Affiliated Organization" field is not being used; always leave this blank.

AMY add new organisation

Memberships

AMY is also used to track all Carpentries memberships. To create a new membership, the site must first be listed as an organisation in AMY.

Select "Memberships" from the top menu bar to view a list of all Memberships. Memberships can be searched by Organisation name, Consortium status, Public/Private listing, Variant, Contribution type, Active status, and allowed or remaining training seats.

Creating memberships

New Memberships can be created one of two ways, based on whether it is an entirely new membership or a renewing membership:

  • New memberships: If this is an entirely new membership, click on the "New Membership" button at the top of the membership page. This will take you to a blank new membership form.

AMY add new membership

  • Renewing memberships: If this is a renewal of a current membership, select that membership and click on the green "Create new & roll-over button" at the bottom of that page. This will take you to a new membership form with some information pre-populated.

AMY membership rollover

Membership fields

The following fields are included in the Member view:

  • Name The name of the membership. If this is a single organisation, it will be that organisation's name. If it is a consortium of several organisations, it will be their collective name.
  • Consortium If this box is checked, you will be able to assign multiple organisations to that membership. If not, you will only be able to assign one organisation to that membership.
  • Can this membership be publicized on The Carpentries websites If Public is selected, the membership will be listed on The Carpentries Members page and data feeds. If Private is selected, it will not be listed.
  • Variant This lists all the membership levels (Gold, Silver, Bronze, etc.)
  • Agreement start and Agreement end Start and end dates of the membership agreement. A notification displays if the membership is not approximately one year long.
  • Extensions Extensions are created using the "Extend" button at the bottom of the main membership page. The duration of the extension can be edited here.
  • Contribution type What the member contribution was (Financial, Person-days, or other)
  • Registration code A unique registration code used to unlock Instructor Training registration in Eventbrite and match up the trainee's application to this membership. These are not automated. Eventbrite registration is manually set up within Eventbrite. Instructor training applications using the member code are manually matched to this member and a training event.
  • Link to member agreement Link to the Google Drive folder with the member agreement.
  • Workshops without admin fee per agreement Number of workshops allowed in the terms of the agreement.
  • Public instructor training seats Number of public instructor training seats allowed in the terms of the agreement.
  • Additional public instructor training seats Number of additional public seats the member may have purchased beyond the standard agreement.
  • In-house instructor training seats Number of in-house instructor training seats allowed in the terms of the agreement. This will typically only apply to Platinum memberships.
  • Additional in-house instructor training seats Number of additional in-house seats the member may have purchased beyond the standard agreement. This will typically only apply to Platinum memberships.
  • Emergency contact Free text field to fill in emergency contact information.

Consortium Memberships

If Consortium is checked, additional affiliated sites can be added to that membership. These will display in the Organisations (members) line of the Member view. For single-site memberships, only the main site can be listed here. For consortium memberships, additional member sites can be added in. These sites must first be listed as an organisation in AMY.

Membership Contacts

Once a new membership has been created, contact people can be assigned to the membership. Contact people can have one of three roles:

  • Billing Contact Person responsible for contracts and invoicing.
  • Programmatic Contact Person responsible for coordination of workshops and instructor training
  • Trainer Person responsible for delivering instructor training

When a new membership is created, a new field called Persons will display. Click Edit in this row to add or edit any contacts. Multiple contacts can have the same role; one contact can have both roles. Existing contacts will be listed here. These Persons must first be listed as a Person in AMY.

AMY Membership Contacts

Extending membership dates

If a membership is granted an extension to the membership date terms, do not change the original membership end date. Instead, click the gray "Extend" button at the bottom of the membership view. Enter in the new membership end date. The number of days of the extension will automatically be calculated. Add in any comments, such as the context for the extension or a link to more information. Multiple extensions can be granted. The duration of the extension can be edited in the membership's edit view. If a second extension is granted, do not edit the original. Instead, click on the gray "Extend" button again to enter in another extension.

AMY Membership Extension Button

Record Membership Extension

Renewing memberships

When a member site renews a membership, do not create a new member record. Instead, click the green "Create new & roll-over" button at the bottom of the membership view. A new member view will appear, with the following fields pre-populated. Any of these values can be edited. A membership can be rolled over only once.

  • Name: Same as previous
  • Can this membership be publicized?: Same as previous
  • Variant: Same as previous
  • Agreement start and Agreement end Starts on end date of previous membership; ends one year from start
  • Contribution type: Same as previous
  • Instructor training seats and workshops allowed: Same as previous or standard amounts allowed for that membership

This also includes the options to automatically copy over member organisations (for consortiums only) and copy over associated persons and their roles.

The number of workshops or instructor training seats rolled over from the previous membership should be manually entered. These workshop/instructor training seats counts will be reflected in the available counts for both the new and previous memberships.

Adding a New Person

A Person record can be created by accepting an Instructor Training application or a Workshop Request form. A Person record can also be created independent of this activity. If a person's record does not exist in the database, it can be added individually or as part of a bulk upload.

Adding an Individual Person Record

Select "New person" and enter in as much information as possible. At minimum a personal name is required. If the airport is not listed, it will need to be added in.

AMY add new person

Adding Bulk Person Records

Person records can also be added in bulk from a .csv file using the Bulk add people menu option in the New menu at the top right or the More menu. Use the blank template to generate a well formed CSV noting each person's personal name, family name (optional), email address (optional), role, and associated event. Any additional information about the person must be entered manually. Note: To bulk add records, the persons must have a role specified (instructor, helper, learner, host) associated with a specific event. Because the learner role at an Instructor Training event requires a membership or open application affiliation, Instructor Training learner roles can not be bulk added.

AMY bulk add person menu

The column for role name must exactly match the instructions here. The event slug must exactly match the slug for the event recorded in AMY. This may include invisible space characters.

This will take you to a screen where you can verify each record, correct any errors, and submit them for bulk upload. If a person with the same name and email already exists in the database, you will be able to match the new entry to the existing record. Otherwise a new person record will be created.

Consents

AMY asks all users for the following consents:

Mandatory consents:

  • I have read and agree to the privacy policy of The Carpentries.
  • I acknowledge that I am at least 16 years old.
  • Do you agree to the transfer of your data outside of the European Economic Area/United Kingdom?

Optional consents:

  • Can we contact you for volunteering opportunities, surveys, feedback, etc.?
  • Do you consent to publish your profile on The Carpentries website?
  • Do you consent to have your name or identity associated with lesson publications?

By default, all consents have null values (i.e., neither yes nor no). After a Person's record has been created, the individual can log in to AMY and edit their own consents. Admin users may also make these edits on behalf of the user, but this should be used only in rare circumstances. Consents are edited in the "Consents" tab in the Person view. This tab also shows the full consent history for the Person.

Some of the questions above are also asked during the instructor training application. If a Person record is created from a training request, the consents from that training request will be carried across to the Person.

Adding a New Airport

Airports are used as approximate geographic identifiers for our instructors. Instructors can self-select the airport closest to them or the airport they most frequently use. Instructors can select an airport only after it has been added to AMY by an admin. Each airport is identified by its three character IATA code which can be looked up using the link in AMY.

Enter in the airport's IATA code, full name, country, and latitude and longitude.

AMY add airport

Adding a New Event

New events can be created one of several ways:

Regardless of how an event is created, roles such as Instructor, Host, and helper can be assigned after the event is created and saved.

Creating a New Event Manually

Go to the New Event page by clicking on New >> New Event in the top right corner, or clicking on the New Event button on the Events listing page.

AMY new event

All fields will need to be manually entered in.

Creating a New Event from URL

If you already have the event's URL with properly formatted metadata using The Carpentries workshop template, some information can automatically be imported. Go to the New Event page by clicking on New >> New Event in the top right corner, or clicking on the New Event button on the Events listing page. Click on the "Import from URL" button and enter the link to the workshop website OR GitHub URL.

AMY new event from URL

If the website repo contained properly formatted data, the slug, start/end dates, and location may automatically be populated. All other fields will need to be manually entered in.

Instructor and helper names will be in the notes field but not assigned in the database.

Creating a New Event from a Workshop Request

A workshop can be requested from a host site, and this information can be used to create an event in AMY. In the "Requests" menu, select one of the following options:

  • Workshop requests
  • Workshop inquiries
  • Self-Organised submissions

AMY workshop requests

This will take you to a summary view of the workshop requests, workshop inquiries, or self-organised submissions. Click on the "information" icon at the right of each row to see more details.

AMY workshop request list

At the bottom of the request information page, the user has the option to accept or discard the request. All requests should be accepted (unless spam or otherwise inappropriate) so The Carpentries can maintain a history of workshop requests. Events can later be tagged as stalled or cancelled. Choosing "Change state to Accepted" will mark it as accepted in the workshop request list but will not create a new event. Select "Accept and create a new event" to create a new event from this request.

This will open a page with a side by side view of the request details and view to create a new event, similar to the general new event page. The new event can be created manually or if available, from the URL, as described above.

AMY workshop accept request

Event fields

  • Slug Create the workshop slug. This must be in the form YYYY-MM-DD-sitename (for example, 2018-01-01-hawkins. The same slug should be used for the workshop's GitHub page and any other place the workshop is identified. If the exact date is not known, XX can replace the month and/or day (for example, 2018-01-xx-starfleet).

  • Workshop Dates If known, enter in the workshop start and dates.

  • Completed Do not check the "Completed" box yet -- this will be checked after the workshop is over to indicate all associated wrap up work is finished.

  • Host Select the Host name from the drop down menu. The Host is the institution where the workshop is actually being held (or would be held for online workshops). If the Host does not appear on the list, create a new organisation.

  • Sponsor Select the Sponsor name from the drop down menu. The Sponsor is the institution responsible for funding or organising the workshop and is often the same as the Host.

  • Membership Select the Membership this event should be applied to, by membership term and membership dates.

  • Administrator Select the administrator from the drop down menu. This will always be Data Carpentry, Library Carpentry, Software Carpentry, Instructor Training, Collaborative Lesson Development Training or Self-Organised.

  • Is this workshop public If the workshop Host consents, choose "Public." This will list the workshop on the websites for The Carpentries, the associated lesson programs, and The Carpentries data feeds. If "Private" it will not be listed publicly anywhere.

  • Assigned to Select the name of The Carpentries team member responsible for managing this workshop. Only AMY admin users appear in this list. This assignment is used in the views throught AMY.

  • Event Tags Tags are used for several purposes as noted below, including event type, event status, lesson program, event status, and administrative attributes. Multiple tags can be selected for any event.

    • automated-email: Administrative. Automated emails are sent only for workshops with this tag.
    • DC: Lesson Program. Identifies workshops teaching from Data Carpentry curricula.
    • LC: Lesson Program. Identifies workshops teaching from Library Carpentry curricula.
    • SWC: Lesson Program. Identifies workshops teaching from Software Carpentry curricula.
    • Circuits: Lesson Program. Identifies "mix and match" workshops teaching across lesson programs.
    • online: Administrative. Identifies workshops taking place on line.
    • TTT: Event type. Identifies Instructor Training events.
    • ITT: Event type. Identifies Trainer Training events.
    • CLDT Event type. Identifies Collaborative Lesson Development Training events.
    • Pilot: Event type. Identifies workshops teaching pilot curricula.
    • for-profit: Administrative. Identifies workshops run by for-profit institutions.
    • Scholarship: Administrative. Identifies sponsored workshops.
    • private-event: Deprecated. Formerly used before explicit private/public field existed.
    • cancelled: Event status. Identifies workshops that got canceled after they were fully scheduled.
    • unresponsive: Event status. Identifies workshops whose Hosts/Instructors are not sending attendance data.
    • stalled: Event status. Identifies workshops where planning began but workshops did not happen.
    • LMO: Event type. Identifies Lesson Maintainer Onboarding sessions (for Lesson Maintainers).
    • LSO: Event type. Identifies Lesson Specific Onboarding sessions (for Instructors).
    • hackathon: Event type.
    • WiSE: Event audience. Identifies workshops for Women in Science and Engineering.

  • TTT Open applications For instructor training events only, member sites become associated with the event as individuals from that member site are assigned to that event. Checking this box will allow people from the open application pool to be matched to this event as well. This box is automatically checked for events with the TTT tag.

  • Curricula taught at the workshop Select the curricula taught at this workshop.

  • Lessons covered Placeholder section for lessons covered

  • URL Enter in the workshop's url (to the website, not the repo). This is generally in the format https://username.github.io/YYYY-MM-DD-sitename. It is created using the template in this GitHub repo.

  • Language Enter in the human language the workshop is taught in. This is especially important for The Carpentries to track workshops in languages other than English.

  • Eventbrite If the workshop is using The Carpentries Eventbrite for registration, enter the Eventbrite key. This is not needed if the host site is using their own Eventbrite account or any other registration system.

  • Manual Attendance After the event is over, record the total number of learners who attended the workshop. This is compared to the count of learner tasks at that event. In the end, the higher value will be displayed. Note The Carpentries does not currently maintain attendance data on its workshops.

  • Additional people to contact Enter only email addresses for any additional contact people for this event. This is intended for people who do not have an official role (Host, Instructor, etc.) at the workshop. Enter emails addresses, one at a time. These individuals do not need a Person record in AMY. They will be included on any automated emails.

  • Location details Add in the location including the country, venue name, address, and latitude/longitude coordinates.

  • Comment Add in any other notes that may not be covered in any fields above. This will be transformed into a timestamped notes log once the event is saved. Comments can be formatted in Markdown.

Recruiting Instructors for Workshops

AMY admins can create a sign up process for badged and active Instructors to express interest in teaching opportunities. The following criteria must be met to begin the instructor signup process:

  • Centrally-Organised workshop
  • Start date in future
  • Complete location information

Once these criteria are met, the admin will see an option to begin the Instructor signup (selection) process:

AMY workshop begin signup process

You will then be taken to a screen to add in more information about this workshop. A priority can be automatically assigned based on how far out the workshop is. This priority can be changed here. You can also share additional notes such as a description of the workshop audience, COVID policy, or other information. Click "Add sign up page" to add this to the sign up page visible to badged and active Instructors.

Automatic priority is defined as follows:

  • For online events: LOW if start >= 60 days; MEDIUM if start > 30 days; HIGH otherwise.
  • For in-person events: LOW if start >= 90 days; MEDIUM if start > 60 days; HIGH otherwise.

AMY workshop signup info

At this point, the workshop will be available for badged and active Instructors to view and consider.

As Instructors register their interest, an admin can track their status from the event page itself to view details of just that workshop, or by selecting the "More >> Instructor selection/recruitment" menu option. The next screen will show who has signed up so far, a summary of their activity as a Helper and Instructor; the Instructor's country; and notes left by the Instructor.

The admin can edit their own notes for each person using the blue edit button, and confirm or decline the Instructor to teach using the confirm or decline buttons. Once an Instructor has been confirmed in this way, an Instructor task is automatically created for this individual.

Once at least two Instructors have been confirmed, the admin may close signups for this workshop. This workshop will then no longer appear on the list of Instructor opportunities.

AMY workshop signup summary

Assigning People to Events

Regardless of how events are created, adding the people associated with each event can not easily be automated. Name matching is hard.

People can be associated with events one by one or as a bulk upload. The person must already be in AMY before assigning them to a role at an event. If an Instructor is assigned via the Instructor Recruitment process, the Instructor role is automatically assigned.

Assigning People to Events, One by One

Go to the event page and click the "Edit" button at the top of the page. Select the "Tasks" tab.

Assign person to task

Fill in the following fields:

  • Person Start typing in the person's name. Auto-completed suggested names will appear.
  • Role Add the person's role in the event (Helper, Instructor, Supporting Instructor, Workshop Host, Learner, Workshop Organiser. Contributed to Lesson Materials is not used in this context.).
  • Title and URL are not used in this context.

If a person's name does not appear in the dropdown, they will need to be added to the database.

If this is a learner role at an Instructor Training event, the following fields should also be filled in. These fields apply only to Instructor Training, and can be left blank for other types of events.

  • Associated member site in TTT event Note the membership (institution name and membership year) that this seat should be assigned to.
  • Count seat as public or in-house? Note whether the learner seat should be counted as public or inhouse. Most seats will be public. Inhouse only applies to select Platinum level memberships.
  • Open training seat Note whether this learner came through our open program, and is not affiliated with a member site.

Click "Submit" to save your changes.

Below this form, a list of all people assigned to this event is displayed, with three options at the end of the row.

  • "i" icon opens a detailed view of this Person's role at this event
  • pencil icon opens an edit view of this Person's role at this event
  • red X icon deletes this Person's role at this event

Manage person tasks

Assigning People to Events in Bulk

See section above.

Instructor Training

Accepting Trainee Applications

In addition to tracking workshops, AMY also allows us to track applications to instructor training events. The public facing application is here. Applicants are given a registration code if participating in a member training event and should select "Profile Creation for Pre-approved Trainees" using this code. Open applicants will not have a registration code.

Once an individual submits the form, they receive an email that confirms their application has been received and includes a copy of the individual's responses. An admin user can then view the record by going to Requests --> Training Requests.

Training request menu

This will display a list of all applications that are Pending or Accepted and Unmatched to an existing person. Applications can then be searched by individual name, email address, group (registration code), status (pending, accepted, discarded, or withdrawn), affiliation, or location. Affiliation and location searches rely on text strings, so UCLA will not return University of California Los Angeles and Joburg ZA will not return Johannesburg or South Africa.

Training request list view

Some trainees will already be in AMY. If there is a record with a matching name and email address, they will show up with a "matched trainee" when you search for them. You can match the application to this trainee, or if the match was incorrect, search for a different Person record or create a new Person.

Match trainee to person

If "matched trainee" is blank, it means a match was not found. If you think a match exists, you can search for it. Otherwise, you will need to create a new person record for them. If you know this person is in AMY under a different name or email address, look this person up here and click "Match to selected trainee account." If this is a new person, click "Create new trainee account." This will create a new Person record for that trainee.

AMY Trainee no match

This will return you to the instructor training application search screen, and this person's record will be updated with the new trainee account.

Continue doing this until all relevant applications have a new trainee account. This must be done individually; it can not be done in bulk.

Once all trainees for a given event have trainee accounts, we can assign them to a specific training event and associate them with a specific member contract. This part can be done in bulk for each group of trainees with a unique training date and member site affiliation. The event and the member agreement must already have been created in AMY.

Check all the names to be assigned to the training event and membership, and then select the training event from the first drop down menu. Select the member agreement from the second drop down menu. If the trainees are coming through the open application process rather than a member agreement, check this box instead of choosing a member agreement.

Click "Accept & match selected trainees to chosen training." The search screen will then update to show that the trainees have been matched to this event. The event page will also update to list these trainees as learners at that event.

Match trainees to instructor training event

Tracking Checkout Progress

The above steps note that a trainee was accepted in to a training event. Completion of the training event and three steps towards trainee checkout can be tracked in AMY.

A list of all current trainees and their progress can be seen on the "Trainees" page under the "More" menu.

Trainees link under More menu

All trainees page

The colour of each item represents its state:

  • Green: Passed
  • Blue: Asked to repeat
  • Yellow: Not evaluated yet
  • Red: Failed

Hover over any item to see more information about it, including its state, date, and any notes.

Click on the plus sign next to a trainee's progress to track a new step for that trainee. Click on the "information" or "pencil" icon at the right of each row to view or edit the trainee's profile.

Each person's individual record also has a line for Instructor Training Progress, where these steps can be tracked and edited in the same way.

Individuals may have multiple entries for any step, especially if they were asked to repeat. Do not edit the previous step; create a new entry if they repeat a step.

AMY checkout progress in instructor profile

Again, hover over any item to see more information, or click the plus sign to add another item.

Adding checkout progress one by one

Click the plus sign in the "Trainees" page or an individual person's record to add a new progress item.

AMY checkout progress steps

  • Trainee The page will pre-fill the trainee if possible. Otherwise, start typing in the person's name. Auto-completed suggested names will appear.
  • Type This will be the training event (Training), the welcome session (Welcome Session), the teaching demo (Demo), or a community contribution (Get Involved). When a choice is made, additional fields may appear (see below).
  • State For the checkout type noted above, indicate if the trainee passed, was asked to repeat, or failed. Failed should only be used in extreme circumstances.
  • Notes Any free notes from the admin. Notes are required if the state is set to Failed, or if certain Get Involved activities have been selected (see table).

Additional fields will appear depending on the Type selection:

  • Event The training event that the trainee attended. The trainee should have a learner task at this event (see Assigning people to events). This field is only required when Type is set to Training.
  • Get Involved activity The activity that the trainee completed for the Get Involved step. This field is only required when Type is set to Get Involved.
    Each activity, when selected, requires some or all of the URL, Date, and Notes fields to be filled as well. The community user guide contains a table of these requirements. When you submit the form, the form will check that the correct fields have been filled and tell you if changes are needed.
  • URL A URL to a GitHub contribution, workshop website, or other contribution. This field is only required for some Get Involved activities (see table).
  • Date The date of the activity (not the date of submission). If the activity took place across multiple days, use the first day. This field is required for all Get Involved activities (see table).

Adding checkout progress in bulk

Checkout progress can only be added in bulk if all selected Trainees have the exact same information for that checkout step (i.e., the same status for the same event). "Get Involved" submissions can not be accepted in bulk. Go to the "Trainees" page under the "More" menu.

To add the same step to many trainees, select the relevant trainees using the checkboxes on the left of each row, then complete the form at the bottom of the page. This form has the same fields as the individual progress form, minus the Trainee field. When the form is submitted, an identical item will be added to each selected trainee.

Bulk add checkout progress form

Updating and deleting checkout progress

Click on any progress item in the "Trainees" view or a person's individual record to view and update the details of that item. On the update page, there is also a "Delete" button in the top right, which will remove the item completely.

Items cannot be updated or deleted in bulk.

Evaluating Get Involved submissions

Trainees may submit a contribution for the Get Involved checkout step through the instructor dashboard - see the community user guide to understand how their side of the submission works.

Submissions must be evaluated by an administrator to ensure that the contribution is valid.

In the "Trainees" page (under the "More" menu), select the filter "Only trainees with unevaluated Get Involved submission" in the left sidebar, then click "Submit" at the bottom of the sidebar. This will update the page to show only trainees awaiting evaluation.

Trainees with unevaluated submissions

The relevant items are shown with a yellow background, which represents the "Not evaluated yet" state. Clicking on any of these items takes you to view the details of the submission and update its state. Notice there is an extra non-editable field: Trainee notes, which contains information provided by the trainee as part of their submission. Change this selection to "Passed" if this is a valid contribution. Otherwise, change this to "Asked to repeat" and contact the individual to inform them.

Progress edit page

Issuing Instructor Badge

The Instructor badge can be issued through a person's record (see Issuing Badges) or through the Trainees page.

On the Trainees page, the Eligible column shows whether the trainee has passed all checkout steps and is eligible for an instructor badge. If the trainee is eligible, the "instructor badge" button will appear green and can be clicked to award the badge. If the trainee is not eligible, the button appears grey and the text is struck through.

Trainees page with instructor eligibility highlighted

This list can also be filtered to only display trainees eligible to be certified using the left side menu.

Traainees page with instructor eligibility filter

If eligible, clicking the green "instructor badge" button on that person's row takes you to a screen where the details of the badge can be added. See Issuing Badges for guidance on completing this form. The Person and Event fields will be pre-filled.

Issuing Badges

The Carpentries has various badges that can be issued, including Instructor, Trainer, Maintainer, and more.

An individual badge can be issued by going to a person's record and clicking the Edit button. Choose the Awards tab on the next screen.

  • Badge The specific badge that is being awarded
  • Awarded The date the badge is being awarded on
  • Event Used only if the badge was offered after an event, such as Instructor Training or Maintainer Onboarding
  • Awarded by The admin user awarding the badge. Not required.

AMY issue badge

Reports

AMY comes with several built in reporting features that can be accessed by clicking Reports in the top menu.

User and Administrator Roles

What you are able to edit or view depends on your assigned role as a user or administrator in AMY.

Instructor Login

Instructors can log in to AMY to view and update their own information. To do so, they must have a valid GitHub username in their profile. Instructors should visit the AMY login page and click on Log in with your GitHub account. More information for the user can be found in the community users guide.

If an instructor is having trouble logging in, an administrator can verify the following information.

  • Be sure the GitHub user name is accurate.
  • Click on Change permissions and be sure Is active is checked. No other permissions should be checked unless the instructor is also an otherwise authorised user.
  • Logging in allowed should show next to the GitHub name in the profile. If it says Allow logging in with GitHub, click this to allow logging in. This must be done after setting permissions to active above.

Admin Roles

Admin users will have rights to view and edit many other parts of the AMY database. The Django admin panel can be accessed from the top right menu, under the user's name, generating a unique URL for the session.

An admin user can view their profile as if they were an ordinary user on this dashboard page.

Automated emails

AMY sends automated emails for workshop administration. The following seven email automations are currently enabled. The content of each email can be viewed by authorized users only. View by selecting Django Admin in the top right menu, and select Email Templates from the admin page.

Email description: Introduction of instructors and host. Sent to: All Workshop Hosts + Instructors
Sent from: Regional coordinator email
Subject: Instructors for {{ workshop_main_type }} workshop organized by {{ workshop_host.fullname }} {% if dates %} on {{ dates }}{% endif %}
Date sent: One hour from when conditions are met.
Conditions: Start date more than seven days in future. Tag is not stalled, canceled, or unresponsive. Has administrator. Has at least two instructors and at least one host. Has at least one supporting instructor if online. Centrally organized only.

Email description: Recruit Helpers.
Sent to: All Workshop Hosts + Instructors
Sent from: Regional coordinator email (admin-xx@carpentries.org)
Subject: Time to Recruit Helpers for {% if workshop_main_type %}{{ workshop_main_type }}{% endif %} workshop at {{ workshop.venue }} {% if dates %} on {{ dates }}{% endif %}
Date sent: 21 days before start date.
Conditions: Start date in future. Tag is not stalled, canceled, or unresponsive. Has administrator. Has at least one instructor or at least one host. Has no helpers. Centrally organized only.

Email description: Website URL is missing.
Sent to: All Instructors
Sent from: Regional coordinator email
Subject: Workshop Website needed for {DC, SWC, LC} workshop at {site} on {dates}
Date sent: 30 days before start date.
Conditions: Start date in future. Tag is not stalled, canceled, or unresponsive. Has administrator. No workshop URL. At least one instructor. Centrally organized or Self organized.

Email description: Supporting Instructor is added to the workshop.
Sent to: Single new supporting instructor
Sent from: Regional coordinator email
Subject: Confirmation of your participation as a Supporting-Instructor for {% if workshop_main_type %}{{ workshop_main_type }}{% endif %} workshop organized by {{ host.fullname }} {% if dates %}({{ dates }}){% endif %}
Date sent: One hour after conditions are met.
Conditions: New role of supporting instructor added. Start date in future. Tag is not stalled, canceled, or unresponsive. Has administrator. Online workshop. Centrally organized only.

Email description: Instructor is added to the workshop.
Sent to: Single new instructor
Sent from: Regional coordinator email
Subject: Confirmation of your participation as an instructor for {% if workshop_main_type %}{{ workshop_main_type }}{% endif %} workshop organized by {{ host.fullname }} {% if dates %} ({{ dates }}){% endif %}
Date sent: One hour after conditions are met.
Conditions: New role of instructor added. Start date in future. Tag is not stalled, canceled, or unresponsive. Has administrator. Centrally organized only.

Email description: A new event is created from Self-Organised Request Form.
Sent to: Form submitter and additional contacts
Sent from: Regional coordinator email
Subject: {{ workshop.host.fullname }} ({{ workshop.slug }}) Workshop
Date sent: One hour after conditions are met.
Conditions: Start date in future. Tag is not stalled, canceled, or unresponsive. Event created from SO form. Self organized only.

Email description: 7 days past the end date of an active workshop.
Sent to: All Workshop Hosts + Instructors
Sent from: Regional coordinator email
Subject: Completed {% if workshop_main_type %}{{ workshop_main_type }}{% else %}Carpentries{% endif %} workshop at {{ workshop.venue }} on {{ dates }} ({{ workshop.slug }})
Date sent: 7 days after end date.
Conditions: End date in past. Tag is not stalled, canceled, or unresponsive. Tag is one of ["LC", "DC", "SWC", "Circuits"]. Centrally organized or Self organized.

Other Tasks

Merging Duplicate Persons, Training Requests, or Events

If duplicate Person, Training Request, or Event records exist, they can be merged. If you know which two records should be merged, you can select them directly. You can also search for possible duplicate records.

Merging two known duplicate records.

AMY merge duplicates menu

Once you select Merge Persons, Merge Events, or Merge Training Requests you will be taken to a screen to select the two Persons, Events, or Training Requests you would like to merge. Start typing in the name or slug, and AMY will autocomplete with possible options.

AMY select Persons to merge

This will take you to a screen listing all the information in that Person's record, and allowing you to choose whether to keep the values in record A or record B. For fields allowing multiple values (such as event tasks), you will also have the option to combine (include all values). For consents, no choice is provided, as the most recently provided consents will always be kept and older consents will be archived. Click "Submit" on the bottom of this screen to complete the merge process.

AMY merge Persons

Searching for possible duplicate Person or Training Request records

If you want to check for duplicate Person or Training Requests in general, you can review a list of possible duplicate records. Select the appropriate option from the "Reports" menu.

AMY find duplicates menu

Here, you will see two lists:

  • Possible duplicate persons. This will include records where another record exists with the personal and family names switched, or a single person with the same personal and family name.
  • Persons with the same names. This compares people with the same personal and family names.

In either case, if these records should be merged, select records A and B. This will take you to the Merge Persons screen (see above). If these individuals are not the same person, select "Mark as Reviewed" and they will not show up in the list of possible duplicates again.

AMY search duplicates

Searching

The quickest and easiest way to search is using the search box in the top menu bar. This will perform a case insensitive search of any field in AMY, including searching for partial matches. For example:

  • 12-12- will match any workshop slug containing that string (essentially any workshop on December 12 of any year.)
  • ola tes will match Nikola Tesla and Nolan Bates
  • stanford will match any one with a stanford email address, with stanford in their name, any workshops with stanford in the slug, or the site Stanford University.

If only one result is found across all fields, AMY will automatically redirect to that result. Otherwise, AMY will redirect to a search results view. The search results view will include a new search box, with results appearing in a tabbed view, separated by Organisations, Memberships, Events, Persons, Airports, Training Requests, and Comments.

This search view can also be accessed directly from the More menu.

Searching for Qualified Instructors

Under the "More" menu, select "Find Workshop Staff." Here you can filter by the following criteria:

  • Airport: This returns a list of all Instructors beginning with those who list that airport as their closest airport, and then continues reaching farther out.
  • Country: This returns a list of all Instructors who are in that country. It does not continue to any proximate countries.
  • Latitude and Longitude: Like the Airport search, this begins with people whose listed airport is closest to that latitude and longitude, and then continues reaching farther out.
  • Has active Instructor Community Role, Has Trainer badge, Was helper at least once before, Was organiser at least once before, Is an in-progress instructor trainee are based on AMY's current records
  • Languages, Knowledge Domains, Gender, and Lessons come from the Person record for that individual. If multiple options are selected, only Instructors who have all of those options on their record will be shown.

Searching for Events

Clicking "Events" on the top menu bar will take you to a list of all recorded events - past, present, and future, including those that were stalled or cancelled. Here you can filter by the following criteria:

  • Assigned to: The admin user the event is assigned to
  • Tags: Any tags applied to that event
  • Host: The organisation hosting the event
  • Administrator The event administrator (A lesson program for centrally organised workshops, self organised, Instructor Training, or Collaborative Lesson Development Training)
  • Completed Whether the "completed" box has been checked, indicating all necessary work for that event is complete
  • Country Country from the event's location
  • Continent Continent based on the country
  • Status Whether the event is active, past, ongoing, upcoming, unpublished, published, detected changes in metadata
  • Ordering Select sort order for returned list

Searching for Organisations

Clicking "Organisations" on the top menu bar will take you to a list of all recorded organisations, regardless of their involvement with The Carpentries. Here you can filter by the following criteria:

  • Country: Country the organisation is based in
  • Memberships (current or past): Whether the organisation has had any current or past membership, by selected membership variant
  • Ordering Select sort order for returned list

Searching for Memberships

Clicking "Memberships" on the top menu bar will take you to a list of all Carpentries memberships - past, present, and future. Here you can filter by the following criteria:

  • Organisation Name: For most memberships, this will be the name of the main organisation. For consortium memberships, this will be the name of the consortium.
  • Consortium: Whether the membership is listed as a consortium
  • Can this membership be publicized on The carpentries websites?: Whether public/private has been selected, allowing the membership to be listed on The Carpentries website
  • Variant: The membership level (bronze, silver, gold, etc.)
  • Contribution type: Financial, Person-days, etc.
  • Only show active memberships
  • Only show memberships with non-zero allowed training seats
  • Only show memberships with zero or less remaining seats
  • Ordering Select sort order for returned list

Searching for Persons

Clicking "Persons" on the top menu bar will take you to a list of all recorded persons, regardless of their involvement with The Carpentries. Here you can filter by the following criteria:

  • Badges This will return Persons who have any of the selected badges
  • Taught at workshops of type This will list Persons who have taught at workshops with any of the selected tags
  • Ordering Select sort order for returned list

See the section above to search specifically for qualified instructors.