FOSSASIA‘s Open Event Server is the REST API backend for the event management platform, Open Event. Here, the event organizers can create their events, add tickets for it and manage all aspects from the schedule to the speakers. Also, once he/she makes his event public, others can view it and buy tickets if interested.
The organizer can see all the attendees in a very detailed view in the event management dashboard. He can see the statuses of all the attendees. The possible statuses are completed, placed, pending, expired and canceled, checked in and not checked in. He/she can take actions such as checking in the attendee.
If the organizer wants to download the list of all the attendees as a CSV file, he or she can do it very easily by simply clicking on the Export As and then on CSV.
Let us see how this is done on the server.
Server side – generating the Attendees CSV file
Here we will be using the csv package provided by python for writing the csv file.
import csv
- We define a method export_attendees_csv which takes the attendees to be exported as a CSV file as the argument.
- Next, we define the headers of the CSV file. It is the first row of the CSV file.
def export_attendees_csv(attendees): headers = ['Order#', 'Order Date', 'Status', 'First Name', 'Last Name', 'Email', 'Country', 'Payment Type', 'Ticket Name', 'Ticket Price', 'Ticket Type']
- A list is defined called rows. This contains the rows of the CSV file. As mentioned earlier, headers is the first row.
rows = [headers]
- We iterate over each attendee in attendees and form a row for that attendee by separating the values of each of the columns by a comma. Here, every row is one attendee.
- The newly formed row is added to the rows list.
for attendee in attendees: column = [str(attendee.order.get_invoice_number()) if attendee.order else '-', str(attendee.order.created_at) if attendee.order and attendee.order.created_at else '-', str(attendee.order.status) if attendee.order and attendee.order.status else '-', str(attendee.firstname) if attendee.firstname else '', str(attendee.lastname) if attendee.lastname else '', str(attendee.email) if attendee.email else '', str(attendee.country) if attendee.country else '', str(attendee.order.payment_mode) if attendee.order and attendee.order.payment_mode else '', str(attendee.ticket.name) if attendee.ticket and attendee.ticket.name else '', str(attendee.ticket.price) if attendee.ticket and attendee.ticket.price else '0', str(attendee.ticket.type) if attendee.ticket and attendee.ticket.type else ''] rows.append(column)
- rows contains the contents of the CSV file and hence it is returned.
return rows
- We iterate over each item of rows and write it to the CSV file using the methods provided by the csv package.
writer = csv.writer(temp_file) from app.api.helpers.csv_jobs_util import export_attendees_csv content = export_attendees_csv(attendees) for row in content: writer.writerow(row)
Obtaining the Attendees CSV file:
Firstly, we have an API endpoint which starts the task on the server.
GET - /v1/events/{event_identifier}/export/attendees/csv
Here, event_identifier is the unique ID of the event. This endpoint starts a celery task on the server to export the attendees of the event as a CSV file. It returns the URL of the task to get the status of the export task. A sample response is as follows:
{ "task_url": "/v1/tasks/b7ca7088-876e-4c29-a0ee-b8029a64849a" }
The user can go to the above-returned URL and check the status of his/her Celery task. If the task completed successfully he/she will get the download URL. The endpoint to check the status of the task is:
and the corresponding response from the server –
{ "result": { "download_url": "/v1/events/1/exports/http://localhost/static/media/exports/1/zip/OGpMM0w2RH/event1.zip" }, "state": "SUCCESS" }
The file can be downloaded from the above-mentioned URL.