summaryrefslogtreecommitdiff
path: root/docs/fr/source/annexe-tech-3-variables.rst
blob: 6e2f39271956c6327706eaf85446202dc136e54b (plain)
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
.. -*- coding: utf-8 -*-

.. _annexe-technique-3-variables:

==============================
Annexe technique 3 - Variables
==============================

:Auteur: Étienne Loks
:Date: 2020-11-24
:Copyright: CC-BY 3.0

----------------------------------

Ces variables sont utilisées pour les configurations des imports, les patrons de documents et la configuration des identifiants, des index personnalisés.

Ces variables correspondent aux noms des champs utilisés en base de données (exemple : ``code_patriarche`` pour accéder au code patriarche d'une opération) ainsi que des « facilitateurs » qui permettent de disposer de champs plus évolués (exemple : ``get_next_index`` pour accéder au prochain numéro d'index).

On peut passer d'un élément lié à un autre (par exemple, accéder à l'opération d'une unité d'enregistrement) avec la notation double tiret `__` et ensuite accéder aux variables de l'élément lié (exemple : ``operation__code_patriarche`` permet d'accéder au code patriarche de l'opération ).

Ci-dessous la liste des variables pour chaque type d'éléments.

Champs adresse
==============

Les champs adresse sont une liste de variables partagées par plusieurs éléments :

- `address` : adresse
- `address_complement` : complément d'adresse
- `postal_code` : code postal
- `precise_town__` :  commune (`name` nom de la commune, `numero_insee` code INSEE, `cached_label` nom commune avec numéro du département entre parenthèses)
- `town` : nom de la commune (saisie libre)
- `country` : nom de pays
- `alt_address` : adresse alternative
- `alt_address_complement` : complément d'adresse de l'adresse alternative
- `alt_postal_code` : code postal de l'adresse alternative
- `alt_town` : nom de la commune (saisie libre) de l'adresse alternative
- `alt_country` : nom de pays de l'adresse alternative
- `phone` : numéro de téléphone
- `phone_desc` : numéro de téléphone - description
- `phone2` : numéro de téléphone (2)
- `phone_desc2` : numéro de téléphone (2) - description
- `phone3` :  numéro de téléphone (3)
- `phone_desc3` : numéro de téléphone (3) - description
- `mobile_phone` : numéro de mobile
- `email` : courriel
- `alt_address_is_prefered` : (booléen) l'adresse alternative est préférée


Champs géographiques
====================

Les champs géographiques sont une liste de variables partagées par plusieurs éléments :

- `spatial_reference_system` : système de référence spatial des coordonnées
- `x` : coordonnée x
- `y` : coordonnée y
- `z` : coordonnée z
- `estimated_error_x` : erreur estimée sur la coordonnée x
- `estimated_error_y` : erreur estimée sur la coordonnée y
- `estimated_error_z` : erreur estimée sur la coordonnée z
- `point` : champ base de données du point (3D) - déduit automatiquement depuis les coordonnées
- `point_2d` : champ base de données du point (2D) - déduit automatiquement depuis les coordonnées
- `point_source` : origine des coordonnées (**P** précis, **T** commune, **M** polygone)
- `point_source_item` : source des coordonnées - géré automatiquement
- `multi_polygon` :
- `multi_polygon_source` : origine du polygone (**P** précis, **T** commune, **M** polygone) 
- `multi_polygon_source_item` : source du polygone - géré automatiquement

Le détail du fonctionnement de ces champs est explicité dans :ref:`« Principes > Notions avancées > Données géographiques » <donnees-geographiques>`.


Personne
========

Chaque personne dispose des champs adresse (cf. ci-dessus), ainsi que des champs suivants :

- `title` : titre
- `salutation` : formule d'appel
- `surname` : prénom
- `name` : nom
- `raw_name` : nom + prénom
- `contact_type__` : type de contact (`label` libellé, `txt_idx` identifiant textuel)
- `comment` : commentaire
- `person_types__` : types de personnes
- `attached_to__` : organisation actuelle (-> organisation)
- `cached_label` : nom généré depuis la formule `person_raw_name` du profil

Auteur
======

- `person` : personne (-> personne)
- `author_type` : type d'auteur (`label` libellé, `txt_idx` identifiant textuel)
- `cached_label` : cache textuel « nom, prénom de la personne - type d'auteur » - à utiliser pour l'affichage

Organisation
============

Chaque organisation dispose des champs adresse (cf. ci-dessus), ainsi que des champs suivants :

- `name` : nom
- `organization_type__` : type de contact (`label` libellé, `txt_idx` identifiant textuel)
- `cached_label` : nom généré - nom ou si non disponible « type d'organisation - adresse - commune »


Documentation
=============

- `title` : titre
- `associated_file` : fichier associé
- `image` : image associée
- `thumbnail` : vignette associée (généré automatiquement depuis une image)
- `associated_url` : adresse web associée (avec ``http://``)
- `index` : index
- `external_id` : identifiant interne 
- `reference` : référence
- `internal_reference` : référence interne
- `source_type` : type de document (`label` libellé, `txt_idx` identifiant textuel, `code` code)
- `publisher__` : éditeur (-> organisation)
- `licenses__` : liste de licence d'utilisation (`label` libellé, `txt_idx` identifiant textuel)
- `tags` : liste d'étiquettes (`label` libellé, `txt_idx` identifiant textuel)
- `language` : langue
- `issn` : code ISSN
- `isbn` : code ISBN
- `source` : source / document parent (-> Document)
- `source_free_input` : source / document parent - saisie libre
- `support_type` : type de support (`label` libellé, `txt_idx` identifiant textuel)
- `format_type` : format (`label` libellé, `txt_idx` identifiant textuel)
- `scale` : échelle
- `authors__` : liste d'auteurs (-> auteur)
- `authors_raw` : saisie libre des auteurs
- `creation_date` : date de création de l'élément en base de données
- `receipt_date` : date de réception
- `receipt_date_in_documentation` : date de réception en documentation
- `item_number` : nombre d'élément
- `description` : description
- `container_id` : ID du contenant contenant le document
- `container_ref_id` : ID du contenant de référence du document
- `comment` : commentaire
- `additional_information` : information additionnelles
- `duplicate` : a des doublons
- `complete_identifier` : identifiant complet personnalisé
- `custom_index` : index personnalisé
- `qrcode` : QR code

Opération
=========

Chaque opération dispose des champs géographiques (cf. ci-dessus), ainsi que des champs suivants :

- `code_patriarche` : code patriarche (ou équivalent)
- `year` : année de l'opération
- `common_name` : nom générique
- `operation_code` : code de l'opération
- `old_code` : ancien code
- `start_date` : date de début du chantier
- `excavation_end_date` : date de fin du chantier
- `end_date` : date de cloture de l'opération
- `report_delivery_date` : date de livraison du rapport
- `scientist__` : responsable d'opération (-> personne)
- `operator__` : opérateur (-> organisation)
- `in_charge__` : responsable
- `collaborators__` : collaborateurs
- `creation_date` : date de création de l'élément en base de données
- `associated_file__` : dossier archéologique associé (-> dossier archéologique)
- `operation_type__` : type d'opération (`label` libellé, `txt_idx` identifiant textuel)
- `surface` : surface totale (m²)
- `remains` : liste des vestiges (`label` libellé, `txt_idx` identifiant textuel)
- `cached_remains` : cache textuel de la liste des vestiges - à utiliser pour l'affichage
- `towns` : liste des communes liées (-> commune, `name` nom de la commune, `numero_insee` code INSEE, `cached_label` nom commune avec numéro du département entre parenthèses)
- `cached_towns_label` : cache textuel de la liste des communes - à utiliser pour l'affichage
- `periods` : liste des périodes (`label` libellé, `txt_idx` identifiant textuel)
- `cached_periods` : cache textuel des périodes - à utiliser pour l'affichage
- `scheduled_man_days` : hommes-jours prévus
- `optional_man_days` : hommes-jours optionnels
- `effective_man_days` : hommes-jours effectifs
- `cost` : coût de l'opération
- `report_processing` : état de traitement du rapport (`label` libellé, `txt_idx` identifiant textuel)
- `fnap_financing` : financement FNAP (%)
- `fnap_cost` :  financement FNAP (€)
- `zoning_prescription` :  booléen - prescription sur zonage
- `large_area_prescription` : booléen - prescription sur une vaste surface
- `geoarchaeological_context_prescription` : booléen - prescription sur un contexte géoarchéologique
- `negative_result` : booléen - résultat considéré comme négatif
- `cira_rapporteur` : rapporteur CIRA (-> personne)
- `cira_date` : date d'avis CIRA
- `operator_reference` : référence d'opérateur
- `address` : adresse
- `comment` : commentaire
- `scientific_documentation_comment` : commentaire sur la documentation scientifique
- `documents__` : documents associés (-> document)
- `main_image__` : image principale de l'opération (-> document) 
- `cached_label` : 
- `archaeological_sites` : 
- `top_sites` : 
- `virtual_operation bool` : 
- `record_quality_type__` : 
- `abstract` : 
- `documentation_deadline` : 
- `documentation_received` : 
- `finds_deadline` : 
- `finds_received bool` : 
- `drassm_code` : code DRASSM
- `seizure_name` : 
- `official_report_number` : 
- `protagonist__` : 
- `applicant_authority__` : 
- `minutes_writer__` : 
- `complete_identifier` : identifiant complet personnalisé
- `custom_index` : index personnalisé
- `qrcode` : QR code