01 Cspro NKT-2017

Programme d’appui budgétaire à la mise en
œuvre du cadre stratégique de lutte contre la

pauvreté en Mauritanie-SBC CSLP III
N° MR/FED/22576
(13 - 25 Février 2017)
CSPro SPSS
SEMINAIRE INTERNATIONAL DE FORMATION

03/03/2023 1
EN s CSPRO & SPSS 2017
Présentation du logiciel CSPro
• CSPro signifie « Census and Survey Processing System »
ou « Système de traitement des données issues des
questionnaires de recensement »
• C’est un logiciel conçu par le Bureau du recensement des
États-Unis d'Amérique. Il est destiné à la saisie et au
traitement des données issues d’enquêtes et de
recensements.
• Il permet de réaliser des interviews assistées par
ordinateur communément appelées aussi interview CAPI
(Computer-Assisted Personal Interviewing)
SEMINAIRE INTERNATIONAL DE
03/03/2023 2
FORMATION A CSPRO & SPSS 2017
Il présente plusieurs avantages :
• facile d’utilisation : avec une aide bien détaillée et
agrémentée d’exemples ;
• traitement des fichiers hiérarchiques avec
plusieurs niveaux;
• gratuit ; ce logiciel, ainsi que sa documentation,
sont gratuits en ligne, quoiqu’une inscription en
ligne avec l’adresse email est exigée.
• complet : il propose tous les contrôles et
corrections relatifs à la saisie et aux phases
postérieures à la saisie (redressements, tabulation
des données, etc.).
03/03/2023 3
CSPro contient plusieurs modules exécutables:
Data Entry : Permet d’ajouter, de modifier, de vérifier et

d’afficher des données (questionnaires). Il offre entre autre la
possibilité de:
• Créer un nombre illimité de formulaires (écrans au écran de
saisie);
• Créer des contrôles de cohérence;
• Affichage des messages définis à l’utilisateur au cours de la
saisie;
• Lire et écrire dans des fichiers secondaires;
• Éviter de saisie plusieurs fois les mêmes informations;
• Produire des statistiques de l'opérateur.
SEMINAIRE INTERNATIONAL DE FORMATION A
4
03/03/2023 CSPRO & SPSS 2017
Batch Editing: Il permet de:
• Identifier et de signaler la structure, la valeur
et les erreurs de cohérence dans les données
du questionnaire;
• Modifier les valeurs (imputation) de données
basées sur des méthodes simples ou
complexes;
• Produire sommaires ou des rapports détaillés
des erreurs et de corrections;
• Plusieurs fichiers de consultation de l'accès ;
• Lire et écrire dans des fichiers secondaires.
03/03/2023 5
Tabulation : Elle permet de :
• Définir et sélectionner les variables à
totaliser. ;
• Sélectionnez l'univers de la totalisation. ;
• Dresser un tableau des valeurs et des poids. ;
• Tableaux de format pour l'affichage ou
l'impression. ;
• Produire des tableaux par zone
géographique. ;
• Carte des résultats par zone géographique.
03/03/2023 6
Data Dictionary :
• Définir l'organisation hiérarchique de fichiers
simple ou complexe;
• Définir les niveaux hiérarchiques, articles
d'identification, des dossiers, des éléments
(champs ou variables), des ensembles de
valeurs (catégories de valeurs), et des valeurs.
Export Data : Permet d’exporter les données sur
d’autres formats : Excel, SAS, SPSS, Stata, R.
03/03/2023 7
INSTALLATION :
La version de CSPro que nous utilisons dans

cette formation est la Version 6.3. Elle est
téléchargeable gratuitement sur :
https://www.census.gov/population/internation
al/software/cspro/csprodownload.html
03/03/2023 8
DISPOSITIF ORGANISATIONNEL ET ARCHITECTURE
TECHNIQUE.
• Exemple de dispositifs :
Le dispositif organisationnel et l’architecture technique dépendent
souvent des types de technologies utilisées. Il en existe trois qui
sont utilisés dans les enquêtes et recensements en fonction des
nouveaux terminaux de collecte (ultra portable, PDA, tablette etc):
• Le Dot Net mis en place par Microsoft qui permet le
développement d’applications sur mobiles et desktops (Utiliser
lors RGPHAE-2013 Sénégal)
• L’Andoid avec le développement d’application de collecte mobile
à partir du langage Java
• CSPro CAPI utilisable à la fois sur windows mobile et sur
Android
03/03/2023 9
LES RESULTATS ATTENDUS DU DISPOSITIF
Quelque soit le dispositif organisationnel, il doit
permettre :
• Une coordination entre les différentes entités qui
composent le dispositif de collecte :
• Le déploiement des applications sur les terminaux
de collectes ainsi que l’installation des mises à jour.
• L’échange des données entre les unités de collectes
et le niveau central/superviseur (pré-chargement
des applications des applications de collecte et
envoi des données collectées vers le niveau central)
03/03/2023 10
Architecture technique proposée
03/03/2023 11
Développement d’une application CAPI
A quelques différences prés, le développement

d’une application CAPI CSPro passe par les mêmes
étapes que celles d’un masque de saisie émanant
d’un questionnaire papier à savoir :
• La définition du dictionnaire des données ;
• La génération du masque de saisie ;
• L’implémentation des contrôles de cohérence.
En plus, il faut ajouter l’activation du mode CAPI, la
définition des types de captures, la segmentation
des différents dictionnaires de données et
l’implémentation de fonctions avancées de CSPro
03/03/2023 12
Nous travaillerons sur les questionnaires de
l’Enquête Permanente sur les Conditions de Vie des
Ménages (EPCV) 2014
LA DEFINITION DU DICTIONNAIRE DES DONNEES
Vue d’ensemble de CSPro au lancement
Formation statistiques agricoles FAO Février

03/03/2023 13
2015
Le dictionnaire des données décrit l’organisation du
fichier de données. Il permet ainsi de préciser la
nature, le type, la taille des records, des variables et
des modalités (selon le cas). Un record
correspond à une section du questionnaire. Il
permet d’enregistrer les réponses relatives aux
questions ( item) traitant d’un thème commun.
Les records (sections) et les items (questions)
possèdent des propriétés (type, libellé, taille, etc.).
03/03/2023 14
Sous-CSPRO, on crée un nouveau dictionnaire des
données en utilisant l’option File/new… du menu.
Le choix de cette option affiche la boîte de dialogue
suivante :

03/03/2023 15
2015
Le type d’objet correspondant au dictionnaire de données
c’est « Data Dictionnary ». En sélectionnant cette option,
l’écran suivant apparait :
Il reste donc à donner un nom au fichier, ainsi que le chemin, puis

cliquer sur create. Un dictionnaire a comme extension « .dcf ».
03/03/2023 16
On obtient alors l’environnement de travail suivant :
03/03/2023 17
Ajouter des records (Sections du questionnaire)
Le dictionnaire initial comporte deux records : un record « Id items » destiné à

contenir l’identifiant (composé le cas échéant de plusieurs variables) et un record vide.
La première chose à faire, c’est (en fonction de la structure du questionnaire) d’insérer
et de modifier le nom des records pour chaque section du questionnaire.
Pour ajouter un record, il est conseillé de cliquer sur le bouton questionnaire de la

fenêtre de gauche. On a:
03/03/2023 18
Caractéristiques d’un record :
• Record Label : il s’agit du libellé que l’on veut donner au record
• Record Name : correspond au nom logique du record, c’est lui qui
sera utilisé le cas échéant dans les procédures de contrôle pour faire
référence au record. Il est composé d’au plus 32 caractères. Les
caractères possibles sont : A-Z, 0-9, et le _. Rmq : la première
position est réservée pour les lettres de A à Z. Par ailleurs, la
dernière position ne saurait être le _. Il faut noter pour finir que
CSPRO possède des noms réservés qui ne peuvent être utilisés au
niveau du dictionnaire.
• Type value : C’est un code alphanumérique qui permet d’identifier
les enregistrements ou records du fichier des données.
• Required : prend deux valeurs possibles : Yes/No. Il s’agit de dire si
pour chaque questionnaire, on a au moins une occurrence de ce
record. Pour le cas du questionnaire EPCV , les sections où il y a des
conditions
03/03/2023 d’éligibilité prennent la valeur No pour cet attribut. 19
AJOUTER DES ITEMS (QUESTIONS)
A cette phase, il ne reste plus qu’à ajouter les items
(questions) à l’intérieur de chaque record (section).
Pour ajouter un item, le processus est le même que
lorsqu’on veut ajouter un record. Cliquer sur le
record à l’intérieur duquel on aimerait ajouter des
items. On a:

03/03/2023 SEMINAIRE2015
INTERNATIONAL DE 20
Les propriétés des items sont différentes de celles
des records :
Start : Champ très important, qui précise la position du fichier à partir
de laquelle la réponse à la question sera stockée. Il est conseillé de
laisser CSPRO gérer automatiquement ce champ, sauf pour le cas des
SubItems (à voir plus loin).
Len : permet de donner la taille du champ en terme de nombre
de positions.
Data Type : permet de préciser le type de donnée du champ en
cours. Les types possibles sont : numériques (ex : Age, taille,..)
et alphanumériques (ex. Nom ; Prenom…).
03/03/2023 21
Les propriétés des items (suite):
Item Type : Par défaut, ce champ prend la valeur Item. Il
existe des questions dont les réponses peuvent être
subdivisées en sous réponses. L’exemple typique est celui de
la date qui est composée du jour, du mois et de l’année. On
peut demander à CSPRO de gérer le jour, le mois et l’année
comme des Subitems de la variable date. Lorsqu’on choisit
Subitem, il faut modifier les propriétés Start et Len de telle
sorte que la position du Subitem coïncide avec la partie de
l’item qu’il représente.
Occ : permet de préciser le nombre d’occurrence de l’item
dans le record. Si on décide par exemple que cette valeur vaut
5 pour une variable qui tient sur deux (02) positions (Len),
CSPRO va réserver 10 positions pour la saisie des
informations sur ce champ.
03/03/2023 SEMINAIRE INTERNATIONAL DE 22
Les propriétés des items (suite):
Dec : correspond au nombre de valeur décimale

d’une variable de type numérique.
Dec char : Vaut Yes ou No, précise pour les variables

numériques avec décimale s’il faut une virgule pour
séparer la partie entière de la partie décimale.
Zéro Fill : Prend deux valeurs possibles : Yes ou No.

Lorsque la valeur choisie est Yes, CSPRO complète (le
cas échéant) les saisies par des zéro à gauche.
03/03/2023 23
AJOUT DES VALUES SETS (MODALITES)
Dans cette partie, nous apprenons à définir les valeurs
valides afin, d’une part, d’éviter la saisie des valeurs
non admisses et d’autre part de créer des classes de
valeur.
A partir du dictionnaire, faites avec un clic droit sur
la variable (item), et cliquer sur «Add Value Set»
pour définir les valeurs valides.
03/03/2023 24
AJOUT DES VALUES SETS (MODALITES) (suite)
• Value Label : doit être renseigné par le libellé de
la modalité concernée
• From : doit être renseigné par le code
correspondant à la modalité. En outre, pour les
variables numériques dont les modalités sont
regroupées en classe, on saisit dans le champ
«From», la borne inférieure
• To : est réservé à la borne supérieure

03/03/2023 25
2015
GENERATION D’UN MASQUE DE SAISIE :
Le masque de saisie se génère, à partir du
dictionnaire des variables.
Une fois le dictionnaire achevé, faire File/New
Ensuite au niveau de la boite de dialogue qui
s’affiche, choisir comme type d’objet «Data
Entry Application», qui permet de créer un
fichier d’extension «ent».
03/03/2023 26
GENERATION D’UN MASQUE DE SAISIE :
Il est important de choisir le dictionnaire adéquat.

il vous revient de trouver le bon dictionnaire en
cliquant sur le bouton
03/03/2023 27
». L’étape suivante est l’affichage de la boîte de
dialogue suivante :
Cliquer enfin sur Ok et le
masque de saisie est généré.

Permet de choisir le nom (Label ou Name) de la variable qui figurera
dans le masque de saisie et l’option Text left et Text Right aide à
Text Options
disposer le Label/Name par rapport au champ de saisie (à droite ou à
gauche)
L’option conduit à une présentation très conviviale des records sous

Roster forme de tableau lorsque ceux-ci ont plus d’une occurrence. Selon la
Options disposition recherchée, choisissez horizontale, verticale ou pas de
03/03/2023 28
Roster du tout.
2015
Require «
L’option ci-avant, si elle est sélectionnée, impose
Enter »
que la saisie de chaque variable soit validée avant
Key on
de passer à un autre champ.
Entry
Use Lorsqu’elle est cochée, cette option permet d’affiche
Subitems dans le masque de saisie les Subitems. l’item pourra
When être déduit comme étant la concaténation de ses
present Subitems.
L’expérience montre que très souvent, le premier

masque de saisie généré est loin d’être acceptable.
03/03/2023 29
Quelques options de mise en forme
Position des variables
Le formulaire de saisie nouvellement généré est très
différent du questionnaire utilisé. Il se présente généralement
sous la forme ci-dessous
03/03/2023 30
Quelques options de mise en forme (suite 1)
Sous CSPro, la mise en forme consiste à ajouter des

textes, changer le positionnement des variables et
tracer des cadres.
ajouter un texte, clic droit sur la page du formulaire
et choisir «Add text»
03/03/2023 31
Champ-miroir :
Des champs miroir peuvent être introduits. Un
champ-miroir est une variable qui est présente dans
un écran de saisie sans qu’on puisse la modifier. Les
identifiants sont très souvent placés comme champs-
miroirs
Pour créer un champ miroir, on fait glisser la variable
concernée du dictionnaire des données vers
l’emplacement souhaité à l’écran de saisie.
03/03/2023 32
Texte et
Add Text pour ajouter un texte et Add Boxes pour
encadré
tracer un trait ou dessiner un encadré.
Propriétés Libellé

Permet de modifier le Label, le nom et la

Form Properties
couleur du Formulaire
Delete Form Permet de supprimer le Formulaire

Add Text Aide à ajouter des textes dans le Formulaire
Add Boxes Aide à ajouter des encadrés, des traits
03/03/2023 33
Add Form Permet d’ajouter des Formulaires

View Logic ou le
affiche le module de programmation des
Bouton procédures de contrôle à la saisie.
03/03/2023 34
LA SPECIFICATION DES PROCEDURES DE CONTROLE
Une fois la mise en forme du masque de saisie

achevée, il convient de spécifier les différents
contrôles de saisie.
les contrôles de validité de code, les amplitudes
des valeurs, les cohérences avec d’autres
variables du même questionnaire
03/03/2023 35
Généralités.
Le langage de programmation sous CSPRO est assez
proche du Pascal. Chaque objet (record, roster, item, etc.)
pour lequel on souhaite établir une procédure de contrôle,
doit obligatoirement posséder une procédure Preproc et/ou
une procédure Postproc
Preproc permet de rédiger les contrôles que l’on
souhaite effectuer avant la saisie d’une quelconque
information concernant l’objet en cours. Aussi,
Preproc est exécutée avant l’apparition du curseur
dans ledit champ
03/03/2023 36
Toutes les procédures débute par le mot clé

PROC suivi du nom de l’objet sur lequel il
s’applique. Exemple :
PROC AGE
Preproc
Instructions A
Postproc
Instructions B
03/03/2023 37
Exemple 1 : Voici une procédure qui affiche le message
«donnée erronée» et impose une nouvelle saisie, si la valeur
saisie ne respecte pas la plage de valeurs permise (le milieu de
résidence est compris entre 1 et 3).
PROC MILIEU
postproc
if $<1 or $>3 then x= errmsg(001) ;
reenter ;
endif ;
03/03/2023 38
Le caractère $ fait référence à l’information
(valeur) qui est entraint d’être saisie. La fonction
reenter maintient le curseur dans le champ en
cours pour une nouvelle saisie. On remarque par
ailleurs que chaque instruction se termine « ; ».
Exemple 2 : traitons d’un cas où, on doit «sauter» à
la question S03Q9, si la réponse est 2 (non).
PROC S03Q3
postproc
if $=2 then
skip to S03Q9 ;
endif ;
03/03/2023
39
Exemple 3 : Traitons d’un cas où, si le ménage

n’a eu aucune naissance (S05Q1=2 ) alors on doit
terminer la section en cours et « sauter » à la
section suivante.
PROC S05Q1
postproc
if $=2 then endsect ;
endif ;
03/03/2023 40
Exemple 4 : Cas où le code de l’équipement correspond
au numéro de ligne de l’enregistrement. Pour gagner du
temps à la saisie, il sera « pré imprimé ».
PROC S05Q1
preproc
S07Q15(noccurs(LOGE_B)+1)= noccurs(LOGE_B)+1;
noinput ;
LOGE_B est le nom logique du record correspondant à la
sous-section 07.2. l’instruction noinput fait passer de la
preproc à la postproc. Ceci interdit toute saisie dans le
03/03/2023 41
SECTION DE DECLARATION (PROC GLOBAL)
Les déclarations et les définitions sont définies dans
la procédure globale. Dans cette section vous déclarez
le mode de fonctionnement (implicite ou explicite),
des variables, des tableaux et des fonctions définies
par l'utilisateur. La procédure globale apparaît
toujours au début du fichier de logique et commence
par la ligne "PROC GLOBAL". À part les fonctions
définies par l'utilisateur, il n'y a aucune déclaration
exécutable dans cette section. Vous pouvez éditer la
section PROC GLOBAL en cliquant sur la plus haute
entrée de l'entrée de données édite l'arbre ou le lot
édite l'arbre.
03/03/2023 42
SECTION DE DECLARATION (PROC GLOBAL)
Exemple :
PROC GLOBAL
set explicit; {mode}
numeric x, xage; (numeric variables) alpha flag;
(alphanumeric variable)
array Relly(5); (numeric array)
 Les fonctions
Des fonctions définies par l'utilisateur sont codées
dans la partie de déclaration (PROC GLOBAL)
d'une application. Une fois définies, elles peuvent
être utilisées n'importe où dans l’application
03/03/2023 43
 Les fonctions
Le format de la commande :
Valeur de retour = nom de fonction (liste de paramètre)
Exemple :
function InitRellyArray (); {user-defined function}
Relly (1) = 3; { enfant du CM }
Relly (2) = 4; { parent du CM }
Relly (3) = 9; { petit-fils du CM }
Relly (4) = 8; { grandparent du CM } end;
03/03/2023 44
 LES OPERATEURS
• opérateurs arithmétiques • comparateurs
Opérateur symbole
Addition + Comparateurs Symbole
Soustraction - Egal à =
Multiplication * Différent de <>
Division / Strictement inférieur à <
Modulo (remainder) % Inférieur ou égal à <=
Exponentiation ^ Strictement supérieur >
à
Supérieur ou égal à >=
Dans la plage In
03/03/2023 45
 LES OPERATEURS
•opérateurs logiques
Operateur Symbole Keyword
Négation ! not
Conjonction (et) & and
union (ou) | or
Si et seulement si <=>
03/03/2023 46
 Liste des commandes
Accept Rend le numéro d'un choix sur une liste proposée à
l'opérateur de saisie de données.
Exemple:

PROC UR
preproc
I = 0;
do until I in 1:2
I = accept("Area Designation?", "Urban", "Rural");
enddo;
$ = I;
noinput;
03/03/2023 47
Advance Avance à un champ indiqué durant

l'entrée de données.

Format 1:
advance [to] field-name;

Format 2:
advance [to] alpha-variable;
03/03/2023 48
Alpha Déclare des variables alphanumériques utilisées dans
l'application.
Format:
alpha [(len)] var-1[, var-2[..., var-n]]);
Si la valeur de len n’est pas précisée, elle prend par défaut la valeur 16.
Exemple 1:
PROC GLOBAL
alpha a,b,c;
alpha(10) x,y;

PROC A1
x = "hi mom";

x sera égal à "hi mom "
03/03/2023 49
x = "good night, mom";

x sera égal "good night"
1234567890
Exemple 2:
PROC GLOBAL
alpha (3) reply;
alpha flag;

PROC Q5
if q5 = 1 then
reply = "Yes";
flag = "Y";
03/03/2023 endif; FORMATION A CSPRO & SPSS 2017
50
Array Déclare un tableau (ou matrice) de 1 à 3
dimensions.
Format:
array [alpha[(len)]] array-name(dim-1[,dim-2[,dim-3]])
[save];

L’option save permet d’initialiser la matrice avec les

données en ligne.
exemple:
PROC GLOBAL
array age_hd (2,8); {sexe par lien de parenté}
03/03/2023 51
exemple:
PROC MY_PROGRAM
preproc
homme = 1;
femme = 2;

age_hd (homme,1) = 20; { CM homme }
age_hd (homme,2) = 24; { époux }
age_hd (homme,3) = 8; { enfant de sexe masculin}
age_hd (femme,1) = 26; { CM femme }
age_hd (femme,2) = 32; { épouse }
age_hd (femme,3) = 5; { enfant de sexe féminin}
03/03/2023 52
Break Sortie d'une boucle, et continue l'exécution

après la commande enddo spécifiant la fin de la boucle.
Exemple :
PROC QUEST
spouse = 0;
for i in PERSON_EDT do
if relationship = 2 then
spouse = i;
break;
endif;
enddo;
03/03/2023 53
Clear Initialise les valeurs en mémoire de

données définies dans des fichiers externes à zéro
ou blanc.
Format:
b = clear(ext-dict);
Close Ferme un fichier externe précédemment ouvert.

Format:
b = close(ext-dict-name | file-name);
03/03/2023 54
Cmcode Rend le nombre de mois depuis l'année 1900
d'une date donnée en mois et année.
Format:
i = cmcode(month,year);
Exemple 1:
XMONTH = 06;
XYEAR = 81;
DATE = cmcode(XMONTH,XYEAR);
La valeur de DATE avec les paramètres donnés [Juin 1981], sera (81 x 12) + 6 = 978.
Exemple 2:
XMONTH = 2;
XYEAR = 2000;
DATE = cmcode(XMONTH,XYEAR);
03/03/2023 55

La valeur de DATE avec les paramètres donnés
[Février 2000], sera ((2000 – 1900) * 12) + 2, ou 1202.
concat Joint deux ou plusieurs caractères alpha.

Format:
s = concat(string-2,string-2[,..,string-n]);
03/03/2023 56
Exemple:
PROC GLOBAL
alpha 30 FIRST_NAME, LAST_NAME, FULL_NAME;

PROC ABC
FIRST_NAME = "John"
LAST_NAME = "Henry"
FULL_NAME = concat(strip(FIRST_NAME)," ",
strip(LAST_NAME));

Le résultat obtenu :
FIRST_NAME = "John "
LAST_NAME = "Henry "
FULL_NAME = "John Henry "

Count Rend le nombre d'occurrences d'un tableau
d'enregistrements répétés ou bien le nombre de fois que la
condition est trouvée.

Format:
i = count(multiple-item [where condition]);

Exemple:

NBR_ENFANT = count(PERSONS where LIEN = 3);
03/03/2023 58
Curocc Rend le numéro de l'enregistrement courant dans un
tableau d'enregistrements répétés.
Format:
i = curocc([group]);
Exemple :
PROC RELATION
if curocc(PERSON_REC) = 1 then
if (LIEN <> 1) then
errmsg("La première personne doit être le CM");
endif;
endif;
03/03/2023 59
Delcase Marque un enregistrement pour sa
suppression dans un fichier externe basé sur une clé.

Format:
b = delcase(ext-dict-name[,var-list]);

var-list permet de définir la clé
03/03/2023 60
Delete Supprime un enregistrement ou plusieurs enregistrements
répétés dans un questionnaire en cours de lecture.
Format:
b = delete(group[occ]);
Exemple (enregistrements multiples):

do varying i = totocc(PERSON_REC) until i <= 0 by (-1)
if rel(i) = notappl and
sex(i) = notappl and
age(i) = notappl then
delete (PERSON_REC(i)); {permet d’enlever les enregistrements vides }
endif;
enddo;
03/03/2023 61
Demode Rend le mode d'entrée de données actuel.
Format:
i = demode();
Il y a trois modes de saisie de données:

• add, pour entrer de nouveaux enregistrements; la valeur retournée par
Demode est '1'
• modify, pour modifier un enregistrement déjà saisi; la valeur
retournée par Demode est '2'.
• verify, pour introduire à nouveau les données et verifier qu’il y a pas
de différences entre les données de la première et deuxième saisie; la
valeur retournée par Demode est '3'.
03/03/2023 62
Exemple:
if demode() = add then
V103 = 3;
endif;
Do Exécute une ou plusieurs déclarations à

plusieurs reprises tandis qu'une condition logique
reste vraie ou bien jusqu'à ce qu'une condition
logique ne soit plus vraie.
03/03/2023 63
Format:
do [[varying] var = expression] while/until condition
[by expression]
instructions;
enddo;
Exemple:
HEAD = 0;
do varying i = 1 until HEAD > 0 or i > totocc(PERSON)
if RELATIONSHIP(i) = 1 then
HEAD = i;
endif;
enddo;
03/03/2023 64
Le même exemple peut être réécrit en utilisant la
condition « while» comme indiqué ci-dessous:

HEAD = 0;
do varying i = 1 while HEAD = 0 and i <=
totocc(PERSON)
if RELATIONSHIP(i) = 1 then
HEAD = i;
endif;
enddo;
03/03/2023 65
Edit Convertit un nombre en caractère.
Format:
s = edit(edit-pattern,numeric-expression);
Exemple 1:
X = 87;
A1 = edit("ZZZ9",X); yields A1 = " 87"
A2 = edit("9999",X); yields A2 = "0087"
A3 = edit("Z999",X); yields A3 = " 087"
03/03/2023 66
Exemple 2:
Y = 0;
A4 = edit("ZZ9",Y); yields A4 = " 0"
A5 = edit("999",Y); yields A5 = "000"
A6 = edit("ZZZ",Y); yields A6 = " "
Exemple 3:
A = edit("99:99:99",sysdate());
Exemple 4:
A = edit("99/99/99",sysdate("DDMMYY"));
Exemple 5:
A = edit("ZZZ,ZZZ,ZZ9",MONTANT);
03/03/2023 67
Endgroup Finit l'entrée de données pour l'enregistrement
courant ou le groupe d'enregistrements.
Exemple:
if KIDSBORN = 0 then
endgroup;
endif;
Endlevel Finit l'entrée de données pour le niveau

actuel.
Exemple:
if MORE_WOMEN = 0 then
endlevel;
endif; SEMINAIRE INTERNATIONAL DE
03/03/2023 68
Enter Permet d'entrer des données à partir d'un
autre formulaire.
Format:
enter form-file-name
Errmsg Montre ou écrit un message.

Format 1 Exemples:

Exemple 1:
errmsg("Le CM est âgé de %d", AGE);
03/03/2023 69
Exemple 2:
errmsg("Plus d’un CM dans un ménage") denom =
PERSON_COUNT summary;
Exemple 3:
errmsg("Le CM est âgé de %d. Son âge doit être >= 12",
AGE)
Format 2 Exemple:
OK = errmsg (1,"June"30,31);
Le fichier message va contenir le texte suivant:
1 %s est de %d jours. Vous avez introduit %d!
03/03/2023 70
Exit Finit une procédure avant que le traitement
normal finisse.
Exemple:
function FIRST_WOMAN();
FIRST_WOMAN = 0;
do i = 1 while i <= HH_MEMBERS
if SEX(i) = 2 then
FIRST_WOMAN = i;
exit;
endif;
enddo;
end;
03/03/2023 71
File Déclare un ou plusieurs fichiers utilisés dans
l'application.
Exemple:
PROC GLOBAL
File FILE_PERSON, FILE_HOUSEHOLD;
fileconcat Cumule plusieurs fichiers définis dans le même

format.
Format:
b = fileconcat(result-file-name, file1[, file2[, ...]]);
Exemple:
fileconcat("c:\prov1\prov1.dat", "c:\prov1\01*.dat");
03/03/2023 72
Filecopy Copie un fichier dans un autre fichier.
Format:
b = filecopy(file-name, result-file-name);
Exemple:
filecopy(DATA, DATACOPY);
03/03/2023 73
impute Assigne une valeur à une variable et
enregistre la fréquence d'assignation.
Format:
impute (item-name, expression)
[stat (item-name1, item-name2,....,item-nameN)]
[title (alpha-expression)]
[vset (vset-number)]
[specific];
Exemple:
impute(P04_AGE, TEMPAGE) title("Age updated via TempAge")
vset(2);
03/03/2023 74
int Rend la partie entière d'une expression
numérique.
Format:
i = int(numeric-expression);
Exemple:
x = int(5 / 3);
La valeur de x sera 1.
03/03/2023 75
invalueset Détermine si une valeur d'une variable est
dans une plage de valeurs.
Format:
b = invalueset(item-name[, valueset-name]);
Exemple 1:
if not invalueset(P03_SEX) then
errmsg("Sexe est invalide. La valeur est %d", P03_SEX);
endif;

Loadcase Charge un enregistrement d'un fichier
externe dans la mémoire à partir de variables servant de
clé.
Format:
b = loadcase(ext-dict-name[, var-list]);
Exemple:
OK = loadcase(SAMPDICT,CLUSTER,HH);

La fonction retourne la valeur 1 (vrai) si l’enregistrement est trouvé et chargé, 0
(faux) dans le cas contraire.
03/03/2023 77
next Finit une boucle, une itération et continue
l'exécution avec l'itération suivante dans la boucle.
Format:
skip [to [next]] field-name;
Exemple:
if Q202 <> 1 then
skip to next Q201;
endif;
03/03/2023 78
noccurs Rend le nombre de présences (d'occurrences)
pour un formulaire se répétant ou une liste.
Exemple:
TOTAL_PERSONS = noccurs(PERSON);
noinput Empêche la saisie pour le champ actuel

pendant l'entrée de données.
Exemple:
PROC Q102
preproc
if Q101 <> 1 then
noinput;
endif;
03/03/2023
79
numeric Déclare des variables numériques utilisées
dans l'application.
PROC GLOBAL
numeric X, Y, male, female;
03/03/2023 80
pos Rend la position d'un caractère dans une série
de caractères.
Format:
i = pos (substring, source);
Exemple 1:
X = pos("L","FOR THE CHILDREN");
La valeur de X sera 12;
Exemple 2:
X = pos("DRE","CHILDREN");
La valeur de X sera 5;
Exemple 3:
X = pos("DCN","CHILDREN");
La valeur de X sera 0.
03/03/2023 81
postproc Déclare que les instructions qui suivent
sont exécutées à la fin d'un bloc.
PROC SEX
postproc
if ($ = 2 and AGE < 5) then
reenter;
endif;
03/03/2023 82
preproc Déclare que les instructions qui suivent
sont exécutées au début d'un bloc.
PROC DATE
preproc
DATE = sysdate("DDMMYYYY");
03/03/2023 83
Recode Assigne une valeur à une variable basée
sur la valeur d'une ou plusieurs autres variables.
Format:
recode var-1 [:var-2 [:var-n]] => var-out;
[range-1] [:range-2 [:range-n]] => exp;
[range-1] [:range-2 [:range-n]] => exp;
: : :
[: [:]] => other-exp;
endrecode;
03/03/2023 84
Exemple 1:
recode AGE => AGE_GROUP;
0-19 => 1;
20-29 => 2;
30-39 => 3;
40-49 => 4;
>= 50 => 5;
=> 9;
endrecode;
Exemple 2:
recode ATTEND : ED_LEVEL => EDUC;
2,notappl : => 1;
1 : 1 => 2;
1 : 2,3 => 3;
: =>
03/03/2023
9;
85
endrecode;
reenter Force l'agent de saisie à ré-entrer le
champ actuel ou précédent.
Format :
reenter [field-name];
Exemple:
if KIDS = 1 & BOYS = 0 & GIRLS = 0 then
reenter KIDS;
endif;
03/03/2023 86
setfile Assigne un fichier de données à un dictionnaire
ou à un fichier déclaré.
Format:
b = setfile(ext-dict-name | file-name, alpha-exp
[, update | append | create]);
Si les options update, append ou create qui sont optionnels, ne sont citées, le
fichier est ouvert en mode update.
Exemple 1:
OK = setfile(LOOKUP, "c:\My Lookup File.dat");
03/03/2023 87
Exemple 2:
OK = setfile(REPORT, REPORT_FILE_NAME, create);
skip Permet de sauter jusqu'à la variable spécifiée au

moment de la saisie.

Format :
skip [to [next]] field-name;

Exemple :
if Q305 <> 2 then
skip to Q307;
endif; SEMINAIRE INTERNATIONAL DE
03/03/2023 88
soccurs Retourne le nombre d'occurrences d'un
enregistrement.
Format:
i = soccurs(record-name);
Exemple:
NUM_HH_MEMBERS = soccurs(PERSON_REC);

03/03/2023 89
2015
sort Fait le tri des occurrences d'un enregistrement
avec comme critère la valeur d'une variable.
Format:
b = sort(group using item);
Exemple:
Sort(PERSON using LINE_NUM);
03/03/2023 90
special Détermine si la valeur d'une variable est
MISSING, NOTAPPL, or DEFAULT.
Format:
b = special(numeric-exp);

le numeric-exp peut être une variable, un champ ou une expression numérique.
03/03/2023 91
sum Retourne la somme d'une variable répétée
plusieurs fois.

Format:
d = sum(multiple-item [where condition]);

Exemple:
TOTAL_INCOME = sum(INCOME);
TOTAL_FEMALE_INCOME = sum(INCOME where SEX = 2);
03/03/2023 92
sysdate Retourne la date du système comme un entier.
Format:
i = sysdate([date-format]); [ ] indique que cette partie est optionnelle.
La date courante sera retournée comme une chaine de caractères en utilisant la
fonction edit comme suit:
edit("99/99/99",sysdate("DDMMYY"));
Exemple :
Si la date courante est 17 Décembre 1999, on aura les résultats suivants:

x = sysdate("DDMMYYYY"); retourne 17121999
x = sysdate("MMYYYY"); retourne 121999
x = sysdate("DD"); retourne 17
x = sysdate();retourne 991217
03/03/2023 93
systime Retourne l'heure du système comme un
entier.
Format:
i = systime();
edit("99:99:99",systime());
Exemple:
TIME = systime();
HOUR = int(TIME / 10000);
MIN = int(TIME / 100) % 100;
SEC = TIME % 100;
tonumber Convertit un caractère alpha en numérique.

Format:
d = tonumber(string-exp);
03/03/2023 94
totocc Retourne le total des occurrences d'un tableau
d'une ou de plusieurs variables.
Format:
i = totocc([group]);
Exemple 1:
if totocc(HOUSING) > 1 then
errmsg("Plus d’un enregistrement habitat");
endif;
Exemple 2:
PROC HOUSING
if totocc() > 1 then
errmsg("Plus d’un enregistrement habitat");
endif;
03/03/2023 95
while Exécute une ou plusieurs instructions une ou
plusieurs fois tant que la condition est vraie.
Format:
while condition do
instructions;
enddo;
03/03/2023 96
Exemple:
i = 1;
NumPeople = totocc (Person);
while i <= NumPeople do
if rel(i) = notappl and sex(i) = notappl and age(i) =
notappl then
delete (PERSON(i));
else
i = i + 1;
endif;
enddo;
03/03/2023 97
write Ecrit dans un fichier texte.
Format:
[b =] write(alpha-exp[,p1[,p2[,...,pn]]]);
In the string expression
%[n]d = insérer un nombre et l’afficher comme un entier
%[n.d]f = insérer un nombre et l’afficher comme une valeur décimale
%[n.d]s = insérer du caractère texte
"n" est la taille du champ et "d" représente la valeur à afficher.
Exemple:
write("Sex = %d", SEX);
03/03/2023 98
writecase Ecrit un enregistrement de la mémoire
dans un fichier externe.
Format:
b = writecase(ext-dict-name[,var-list]);

Exemple:
OK = writecase(KIDS,CLUSNUM,HHNUM,LINE);
03/03/2023 99
03/03/2023 100
2015
Implémentation de la fonctionnalité CAPI
Pour utiliser le CAPI de CSPro, vous devez cocher l’option

« CAPI mode » situé au niveau des options. Pour ce faire :
 Cliquez sur « Options » au niveau du menu puis sur « Data

Entry »
03/03/2023 101
 La fenêtre suivante s’ouvre, cocher les options
« CAPI mode » (1) et « All fields » située au
niveau de « Use Extends Controls » (2)
Formation2statistiques agricoles FAO Février

03/03/2023 102
2015
 A présent l’option CAPI est active et vous verrez, que
pour chaque item, l’application affichera les modalités
dès que le curseur y est pointé.
Cependant, pour que l’application puisse vraiment être

adaptée à la collecte, vous devez faire un certain nombre
d’opérations supplémentaires pour la rendre plus
conviviale. SEMINAIRE INTERNATIONAL DE
03/03/2023 103
Affiner la présentation : Sélection des contrôles
étendus
Souvent, il peut être utile pour afficher à un
recenseur ou enquêteur les valeurs possibles pour
un champ donné, de le présenter sous un certain
format.
Pour modifier le type de capture pour un champ,
Cliquez sur le champ puis appuyer sur le clic droit et
« field's properties » , choisir « Capture Type » ->
Change.
03/03/2023 104
CSPro vous permet de sélectionner le type de capture qui
est approprié pour le premier jeu de valeur de l'élément.
Pour un contrôle basé sur le programme, voir la fonction de
setcapturetype. Le concepteur CSPro montre les domaines
qui utilisent des contrôles étendus par la coloration de la
frontière du champ en bleu.
03/03/2023 105
Types de capture
L'attribut Zone de texte est l'option par défaut pour un

champ et indique qu'aucun contrôle étendu (modalités de
réponses) ne s’affiche. En CSPro 5.0, les options « menu
déroulant » et « Combo Box » sont du même type de
capture.
03/03/2023 106
Bouton radio
Le bouton radio peut être sélectionné pour les
variables qualitatives à réponse unique. Il se
présente comme suit :
03/03/2023 107
Check Box
Les cases à cocher sont utilisées pour capturer des
variables de réponse multiples. Pour qu’un champ
puisse être configuré comme une case à cocher,
elle doit être de type alpha. La longueur du champ
doit être égale au nombre de possibilités
maximales de réponse.
03/03/2023 108
Drop Down / Combo Box
Ce type de capture affiche toutes les valeurs de la valeur
principale qui est prévue d'un élément numérique ou alpha.
Contrairement à la case d'option Type de capture, le menu
déroulant Type de capture permet l'affichage des gammes
de valeurs (ce est-ensembles de valeurs de "valeurs").
03/03/2023 109
Date
Le type date est valide pour alpha et articles numériques de longueur
4, 6 ou 8. Le choix du format de la date affecte la façon dont la date est
stockée dans le champ.
03/03/2023 110
Number Pad
Certains utilisateurs le trouvent encombrant à utiliser le
clavier à l'écran lors de la saisie des données sur une tablette.
Cette commande affiche un pavé numérique pour entrer des
valeurs numériques avec le doigt ou la souris.
03/03/2023 111
Utilisation de la fonction « Set Attributes ».
A la place de l’utilisation des captures. La fonction « Set

attributes » permet de présenter la liste des modalités sous
forme de menu. Elle doit être déclarée en preproc comme
suit :
Les modalités s’afficheront comme suit.
03/03/2023 112
OUTER UN LIBELLÉ POUR CHAQUE QUESTION :
Une fois le mode capi activé, CSPro vous permet pour chaque
question d’ajouter une description complète ou des
instructions. Cette description apparaitra au moment de
l’interview au niveau d’un cadre situé en haut de l’écran.
Généralement, c’est le texte que lit l’enquêteur à l’enquêté.
Pour ajouter cette description, vous devez cliquer
sur l’item et cliquer sur
situé au niveau de la barre d’outils ci-après situé

en haut de l’écran.

03/03/2023 113
2015
Vous pouvez ajouter à la description qui concerne l’item,
le nom de l’enquêteur ou de l’interviewé par exemple) en
encadrant le nom de la variable par le symbole « % ».
03/03/2023 114
FAIRE
CSDES MENUS :
Pro vous permet de faire des menus avec la fonction accept, elle s’utilise comme
suit :
choice = accept( "Indiquer une action",
"C Commencer l'interview.............................................C", {1}
"S Sauvegarder et prendre un nouveau rendez vous…..S", {2}
"I Insdisponible: Changer de ménage.............................I", {3}
"R Refus, abandonner le ménage.....................................R"); {4}
Le menu se présente comme suit :
03/03/2023 115
La première ligne (Indiquer une action) est le titre de la
fenêtre et les lignes restantes sont les options du menu. S’il
clique sur la troisième ligne, la fonction va retourner la valeur
3. L’action va résulter de l’exécution des instructions
suivantes: if choice=1 then
instructions ;
elseif choice=2 then
instructions ;
instructions ;
instructions ;
endif ;
03/03/2023 116
Déploiement de l’application
L’application CSPRo CAPI peut être déployéesur :
 un ordinateur ou ultra portable ;

 un PDA avec Windows Mobile et CSPRo 6.1;
 un Smartphone avec Androïd et CSPRo 6.0;
Pour celà, il faut procéder ainsi :
Générer une version binaire (compilée) de l'application. Pour ce

faire, ouvrez votre application dans CSPro et choisissez
"Générer binaire" dans le menu de fichier. Selon le système
d’exploitation utilisé (Windows mobile ou Androïd)
03/03/2023 117
03/03/2023 118
Préparez un fichier .PFF. Ce fichier indique les fichiers
de données CSPro à utiliser avec votre application.
Lorsque vous exécutez votre application sur l'ordinateur
de bureau, CSPro génère automatiquement un
fichier .PFF.
 Copiez les fichiers .ENC et .PFF sur le PDA. La

meilleure façon de le faire est d'utiliser ActiveSync.
Cliquez sur le bouton "Explorer" dans ActiveSync
pour parcourir les fichiers sur votre ordinateur de
poche.
03/03/2023 119
Vous pouvez ensuite faire glisser et déposer le .PFF et .enc de
l'ordinateur de bureau vers le PDA à l’endroit indiqué dans le schéma
ci-dessous
03/03/2023 120
Vous devez placer les .PFF et les fichiers .ENC dans le
dossier Mes Documents ou un sous-dossier du dossier
Mes documents ou encore un dossier sur la carte de
stockage SD. Les fichiers Windows Mobile standard
utilisés dans CSPro ne pointent que dans ces dossiers.
Une fois les fichiers ont été copiés sur le PDA, vous êtes
prêt à exécuter l'application sur le PDA.
03/03/2023 121
Etude de Cas : Développement d’une application CAPI
03/03/2023 122
03/03/2023 123

01 Cspro NKT-2017

Transféré par

Droits d'auteur :

Formats disponibles

01 Cspro NKT-2017

Transféré par

Informations du document

Titre original

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

01 Cspro NKT-2017

Transféré par

Droits d'auteur :

Formats disponibles

Programme d’appui budgétaire à la mise en

œuvre du cadre stratégique de lutte contre la

SEMINAIRE INTERNATIONAL DE FORMATION

Data Entry : Permet d’ajouter, de modifier, de vérifier et

La version de CSPro que nous utilisons dans

A quelques différences prés, le développement

Formation statistiques agricoles FAO Février

Formation statistiques agricoles FAO Février

Il reste donc à donner un nom au fichier, ainsi que le chemin, puis

Le dictionnaire initial comporte deux records : un record « Id items » destiné à

Pour ajouter un record, il est conseillé de cliquer sur le bouton questionnaire de la

Formation statistiques agricoles FAO Février

Dec : correspond au nombre de valeur décimale

Dec char : Vaut Yes ou No, précise pour les variables

Zéro Fill : Prend deux valeurs possibles : Yes ou No.

Formation statistiques agricoles FAO Février

Il est important de choisir le dictionnaire adéquat.

Cliquer enfin sur Ok et le

masque de saisie est généré.

L’option conduit à une présentation très conviviale des records sous

L’expérience montre que très souvent, le premier

Sous CSPro, la mise en forme consiste à ajouter des

Permet de modifier le Label, le nom et la

Delete Form Permet de supprimer le Formulaire

Une fois la mise en forme du masque de saisie

Toutes les procédures débute par le mot clé

Exemple 3 : Traitons d’un cas où, si le ménage

Supérieur ou égal à >=

Advance Avance à un champ indiqué durant

L’option save permet d’initialiser la matrice avec les

Break Sortie d'une boucle, et continue l'exécution

Clear Initialise les valeurs en mémoire de

Close Ferme un fichier externe précédemment ouvert.

concat Joint deux ou plusieurs caractères alpha.

03/03/2023 SEMINAIRE INTERNATIONAL DE 57

Exemple (enregistrements multiples):

Il y a trois modes de saisie de données:

Do Exécute une ou plusieurs déclarations à

Endlevel Finit l'entrée de données pour le niveau

Errmsg Montre ou écrit un message.

fileconcat Cumule plusieurs fichiers définis dans le même

03/03/2023 SEMINAIRE INTERNATIONAL DE 76

noinput Empêche la saisie pour le champ actuel

skip Permet de sauter jusqu'à la variable spécifiée au

Formation statistiques agricoles FAO Février

tonumber Convertit un caractère alpha en numérique.

Pour utiliser le CAPI de CSPro, vous devez cocher l’option

 Cliquez sur « Options » au niveau du menu puis sur « Data

Formation2statistiques agricoles FAO Février

Cependant, pour que l’application puisse vraiment être

L'attribut Zone de texte est l'option par défaut pour un

A la place de l’utilisation des captures. La fonction « Set

Les modalités s’afficheront comme suit.

situé au niveau de la barre d’outils ci-après situé

Formation statistiques agricoles FAO Février

L’application CSPRo CAPI peut être déployéesur :

 un ordinateur ou ultra portable ;

Pour celà, il faut procéder ainsi :

Générer une version binaire (compilée) de l'application. Pour ce