72c834ed12
Ensure an event is fired whenever a student updates/creates its course goal.'edx.course_goal.created' and 'edx.course_goal.updated' should be sent after creation and updation respectively. LEARNER-3352
130 lines
4.4 KiB
Python
130 lines
4.4 KiB
Python
"""
|
|
Course Goals Views - includes REST API
|
|
"""
|
|
import analytics
|
|
|
|
from django.contrib.auth import get_user_model
|
|
from django.conf import settings
|
|
from django.db.models.signals import post_save
|
|
from django.dispatch import receiver
|
|
from django.http import JsonResponse
|
|
from edx_rest_framework_extensions.authentication import JwtAuthentication
|
|
from eventtracking import tracker
|
|
from opaque_keys.edx.keys import CourseKey
|
|
from openedx.core.lib.api.permissions import IsStaffOrOwner
|
|
from rest_framework import permissions, serializers, viewsets, status
|
|
from rest_framework.authentication import SessionAuthentication
|
|
from rest_framework.response import Response
|
|
|
|
from .api import get_course_goal_options
|
|
from .models import CourseGoal, GOAL_KEY_CHOICES
|
|
|
|
|
|
User = get_user_model()
|
|
|
|
|
|
class CourseGoalSerializer(serializers.ModelSerializer):
|
|
"""
|
|
Serializes CourseGoal models.
|
|
"""
|
|
user = serializers.SlugRelatedField(slug_field='username', queryset=User.objects.all())
|
|
|
|
class Meta:
|
|
model = CourseGoal
|
|
fields = ('user', 'course_key', 'goal_key')
|
|
|
|
|
|
class CourseGoalViewSet(viewsets.ModelViewSet):
|
|
"""
|
|
API calls to create and update a course goal.
|
|
|
|
Validates incoming data to ensure that course_key maps to an actual
|
|
course and that the goal_key is a valid option.
|
|
|
|
**Use Case**
|
|
* Create a new goal for a user.
|
|
* Update an existing goal for a user
|
|
|
|
**Example Requests**
|
|
POST /api/course_goals/v0/course_goals/
|
|
Request data: {"course_key": <course-key>, "goal_key": "<goal-key>", "user": "<username>"}
|
|
|
|
Returns Http400 response if the course_key does not map to a known
|
|
course or if the goal_key does not map to a valid goal key.
|
|
"""
|
|
authentication_classes = (JwtAuthentication, SessionAuthentication,)
|
|
permission_classes = (permissions.IsAuthenticated, IsStaffOrOwner,)
|
|
queryset = CourseGoal.objects.all()
|
|
serializer_class = CourseGoalSerializer
|
|
|
|
def create(self, post_data):
|
|
""" Create a new goal if one does not exist, otherwise update the existing goal. """
|
|
# Ensure goal_key is valid
|
|
goal_options = get_course_goal_options()
|
|
goal_key = post_data.data['goal_key']
|
|
if goal_key not in goal_options:
|
|
return Response(
|
|
'Provided goal key, {goal_key}, is not a valid goal key (options= {goal_options}).'.format(
|
|
goal_key=goal_key,
|
|
goal_options=goal_options,
|
|
),
|
|
status=status.HTTP_400_BAD_REQUEST,
|
|
)
|
|
|
|
# Ensure course key is valid
|
|
course_key = CourseKey.from_string(post_data.data['course_key'])
|
|
if not course_key:
|
|
return Response(
|
|
'Provided course_key ({course_key}) does not map to a course.'.format(
|
|
course_key=course_key
|
|
),
|
|
status=status.HTTP_400_BAD_REQUEST,
|
|
)
|
|
|
|
user = post_data.user
|
|
goal = CourseGoal.objects.filter(user=user.id, course_key=course_key).first()
|
|
if goal:
|
|
goal.goal_key = goal_key
|
|
goal.save(update_fields=['goal_key'])
|
|
else:
|
|
CourseGoal.objects.create(
|
|
user=user,
|
|
course_key=course_key,
|
|
goal_key=goal_key,
|
|
)
|
|
data = {
|
|
'goal_key': str(goal_key),
|
|
'goal_text': str(goal_options[goal_key]),
|
|
'is_unsure': goal_key == GOAL_KEY_CHOICES.unsure,
|
|
}
|
|
return JsonResponse(data, content_type="application/json", status=(200 if goal else 201))
|
|
|
|
|
|
@receiver(post_save, sender=CourseGoal, dispatch_uid="emit_course_goals_event")
|
|
def emit_course_goal_event(sender, instance, **kwargs):
|
|
name = 'edx.course.goal.added' if kwargs.get('created', False) else 'edx.course.goal.updated'
|
|
tracker.emit(
|
|
name,
|
|
{
|
|
'goal_key': instance.goal_key,
|
|
}
|
|
)
|
|
if settings.LMS_SEGMENT_KEY:
|
|
update_google_analytics(name, instance.user.id)
|
|
|
|
|
|
def update_google_analytics(name, user_id):
|
|
""" Update student course goal for Google Analytics using Segment. """
|
|
tracking_context = tracker.get_tracker().resolve_context()
|
|
context = {
|
|
'ip': tracking_context.get('ip'),
|
|
'Google Analytics': {
|
|
'clientId': tracking_context.get('client_id')
|
|
}
|
|
}
|
|
analytics.track(
|
|
user_id,
|
|
name,
|
|
context=context
|
|
)
|