Code du formulaire

👨‍💻️ Qu'est-ce que le code du formulaire ?

Le code du formulaire vous permet d'exécuter du code JavaScript personnalisé lors du démarrage et de l'exécution du Sondage.

Votre code personnalisé doit étendre le NGSFormCode objet pour être exécuté.

/*
 Exemple montrant comment envoyer les réponses du Répondant 
 à une API REST tierce.

 Le code du Formulaire peut également être utilisé pour insérer des 
 codes API tiers dans votre page de formulaire en utilisant les événements onInit ou onLoaded
*/
class CustomFormCode extends NGSFormCode { 
  /* Le formulaire a été chargé */
  onInit() {}

  /* Un élément de sécurité nécessitant une authentification sera appelé 
     lorsqu'un Sondage requiert une authentification d'un élément de sécurité  
  */
  onAuthenticate(securityItem) {}

  /* Un élément de sécurité nécessitant une authentification sera appelé 
     un élément de sécurité a été authentifié avec succès. 
     Retourner une chaîne depuis cette méthode bloquera 
     l'accès au Sondage avec le message défini par la 
     chaîne retournée.  
  */
  onAuthenticated(securityItem, securityItemAuthorization) {}

  /* Le formulaire a été autorisé par tous les éléments de sécurité et chargé  
    avec les questions de sa première page visible */
  onLoaded() {}

  /* Déclenché lorsqu'une nouvelle page est en cours de chargement ; une valeur nulle pour la page 
    indique que la page de remerciement finale est en cours de chargement 
  */
  onPageLoad(page) {}

  /* Déclenché une fois que les réponses de la session du Répondant ont été enregistrées sur le serveur.
  action définit l'action qui a déclenché l'enregistrement de la progression ; elle peut être l'une des valeurs suivantes
  None = 0, Button = 1, PageChange = 2, QuestionChange = 3, Email = 4, Auto = 5 
  */
  onSaveProgress(ngsRespondent, action) {}

  /* Déclenché une fois que les réponses du Répondant ont été enregistrées sur le serveur. */
  onSubmit(ngsRespondent) {
    // Détails du Répondant
    console.log(ngsRespondent.respondent);

    // Réponses du Répondant
    console.log(ngsRespondent.answers);

    // valeurs des attributs de données des éléments de sécurité
    console.log(ngsRespondent.dataAttributes);
    
    this.formContext.httpClient.post('http://www.yourrestsite.com/yourapi/saveanswers', 
        ngsRespondent.answers, {}).subscribe();
  }

  /* Déclenché une fois que les réponses du Répondant ont été mises à jour sur le serveur. */
  onUpdate(ngsRespondent) {console.log('update', ngsRespondent);}
}

Le NGSForm la classe de base fournit les propriétés suivantes que vous pouvez réutiliser dans votre classe dérivée.

class NGSFormCode {
    // Sondage en cours
    survey;
    // Classe d'assistance du contexte du formulaire
    formContext;
    // Réponses actuelles du Répondant
    respondentAnswers;
    // Répondant actuel
    respondent;
    // Code de langue en cours d'exécution
    language;
    // Valeurs actuelles des attributs de données des éléments de sécurité
    dataAttributesValues;
 }

FormContext fournit les propriétés suivantes que vous pouvez utiliser depuis votre classe dérivée NGSFormCode via la propriété formContext.

export class FormContext {
    // Réponses actuelles du Répondant
    private respondentAnswers$: Observable<RespondentAnswer[]>,
    // Attributs de données actuels des éléments de sécurité
    private dataAttributesValues$: Observable<RespondentAnswer[]>,
    // Langue actuelle du Répondant
    private language$: Observable<Language>,
    // Client HTTP Angular
    private httpClient: HttpClient,
}

Chiffrement des sont les propriétés du répondant

export interface Respondent {
  id: string;
  surveyId?: string;
  panelistId?: string;
  contextUsername?: string;
  resumeUId?: string;
  resumePageId?: string;
  resumeQuestionId?: string;
  startDate: Date;
  voteDate?: Date;
  archiveDate?: Date;
  iPSource?: string;
  changeUID?: string;
  progressSaveDate?: Date;
  languageCode: string;
  timeToEnd?: number;
  validated: boolean;
  userAgent?: string;
  platform?: string;
  platformOS?: number;
  mobileOS?: boolean;
  longitude?: number;
  latitude?: number;
}

Chiffrement des sont les propriétés du répondant

export interface Respondent {
  id: string;
  surveyId?: string;
  panelistId?: string;
  contextUsername?: string;
  resumeUId?: string;
  resumePageId?: string;
  resumeQuestionId?: string;
  startDate: Date;
  voteDate?: Date;
  archiveDate?: Date;
  iPSource?: string;
  changeUID?: string;
  progressSaveDate?: Date;
  languageCode: string;
  timeToEnd?: number;
  validated: boolean;
  userAgent?: string;
  platform?: string;
  platformOS?: number;
  mobileOS?: boolean;
  longitude?: number;
  latitude?: number;
}

SecurityItemAuthorization garde la trace de toutes les propriétés retournées par un élément de sécurité authentifié.

export interface SecurityItemAuthorization {
  securityItemId?: string;
  authorizationToken?: string;
  sessionCode?: string;
  sessionRespondent?: NGSRespondent;
  sessionPanelist: NGSPanelist;
  dataAttributesValues?: SecurityItemDataAttributeValue[];
}