Customize surveys using JavaScript

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// uppercase.js
function toUpperCase(input) {
  if (input == null || input === '') return '';
  return input.toString().toUpperCase();
}

function formatName(firstName, lastName) {
  if (!firstName && !lastName) return '';
  var first = firstName ? firstName.trim() : '';
  var last = lastName ? lastName.trim() : '';
  // Filter out empty strings and join with space to avoid leading/trailing spaces
  var names = [first, last].filter(function(n) { return n; });
  return names.join(' ');
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
// validation.js
function validateEmail(email) {
  try {
    if (!email) return 'Email is required';

    var emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
    if (!emailRegex.test(email)) {
      return 'Please enter a valid email address';
    }

    return 'valid';
  } catch (error) {
    return 'Validation error occurred';
  }
}

function validateAge(age, minAge, maxAge) {
  try {
    if (!age) return 'Age is required';

    var numAge = parseInt(age);
    if (isNaN(numAge)) return 'Age must be a number';

    if (numAge < minAge || numAge > maxAge) {
      return 'Age must be between ' + minAge + ' and ' + maxAge;
    }

    return 'valid';
  } catch (error) {
    return 'Validation error occurred';
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
// calculations.js
function calculateDistance(lat1, lon1, lat2, lon2) {
  // Calculate distance between two coordinates using Haversine formula (in meters)
  if (!lat1 || !lon1 || !lat2 || !lon2) return null;

  try {
    var lat1Rad = parseFloat(lat1) * Math.PI / 180;
    var lat2Rad = parseFloat(lat2) * Math.PI / 180;
    var deltaLat = (parseFloat(lat2) - parseFloat(lat1)) * Math.PI / 180;
    var deltaLon = (parseFloat(lon2) - parseFloat(lon1)) * Math.PI / 180;

    var a = Math.sin(deltaLat / 2) * Math.sin(deltaLat / 2) +
            Math.cos(lat1Rad) * Math.cos(lat2Rad) *
            Math.sin(deltaLon / 2) * Math.sin(deltaLon / 2);

    var c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
    var earthRadius = 6371000; // Earth radius in meters

    return Math.round(earthRadius * c * 10) / 10; // Round to 1 decimal place
  } catch (error) {
    return null;
  }
}

function convertToDMS(decimal, isLatitude) {
  // Convert decimal degrees to Degrees Minutes Seconds format
  if (decimal == null || decimal === '') return '';

  var absolute = Math.abs(parseFloat(decimal));
  var degrees = Math.floor(absolute);
  var minutesDecimal = (absolute - degrees) * 60;
  var minutes = Math.floor(minutesDecimal);
  var seconds = Math.round((minutesDecimal - minutes) * 60 * 100) / 100;

  var direction = '';
  if (isLatitude) {
    direction = decimal >= 0 ? 'N' : 'S';
  } else {
    direction = decimal >= 0 ? 'E' : 'W';
  }

  return degrees + '° ' + minutes + "' " + seconds + '" ' + direction;
}

function calculateArea(length, width, unit) {
  // Calculate area and convert units (supports meters and feet)
  if (!length || !width) return null;

  var lengthNum = parseFloat(length);
  var widthNum = parseFloat(width);

  if (lengthNum <= 0 || widthNum <= 0) return null;

  var area = lengthNum * widthNum;

  // Convert to acres or hectares based on unit
  if (unit === 'feet') {
    return Math.round(area / 43560 * 100) / 100; // Convert sq ft to acres
  } else {
    return Math.round(area / 10000 * 100) / 100; // Convert sq m to hectares
  }
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
// transformation.js
function formatPhoneNumber(phone) {
  if (!phone) return '';

  // Remove all non-digit characters
  var digits = phone.replace(/\D/g, '');

  if (digits.length === 10) {
    return '(' + digits.slice(0,3) + ') ' + digits.slice(3,6) + '-' + digits.slice(6);
  } else if (digits.length === 11 && digits[0] === '1') {
    return '+1 (' + digits.slice(1,4) + ') ' + digits.slice(4,7) + '-' + digits.slice(7);
  }

  return phone; // Return original if can't format
}

function parseAddressStreet(address) {
  if (!address) return '';
  var parts = address.split(',');
  return parts[0] ? parts[0].trim() : '';
}

function parseAddressCity(address) {
  if (!address) return '';
  var parts = address.split(',');
  return parts[1] ? parts[1].trim() : '';
}

function parseAddressState(address) {
  if (!address) return '';
  var parts = address.split(',');
  return parts[2] ? parts[2].trim() : '';
}

function parseAddressZip(address) {
  if (!address) return '';
  var parts = address.split(',');
  return parts[3] ? parts[3].trim() : '';
}

function formatCurrency(amount, currency) {
  if (!amount || isNaN(amount)) return '';

  currency = currency || 'USD';
  var numAmount = parseFloat(amount);

  // Simple currency formatting that works in all JavaScript environments
  // Note: Intl.NumberFormat may not be available in Survey123's sandboxed environment
  var formatted = numAmount.toFixed(2);
  var symbol = currency === 'USD' ? '$' : currency + ' ';
  return symbol + formatted.replace(/\B(?=(\d{3})+(?!\d))/g, ',');
}