<aside> <img src="/icons/list-indent_blue.svg" alt="/icons/list-indent_blue.svg" width="40px" /> Table des matières

<aside> <img src="/icons/chat_blue.svg" alt="/icons/chat_blue.svg" width="40px" /> 📢 Français

📢 English

</aside>

</aside>

<aside> <img src="/icons/info-alternate_blue.svg" alt="/icons/info-alternate_blue.svg" width="40px" /> Et pour en savoir plus

Ma généalogie avec Gramps

Gramps. Présentation

Mon Gramps

</aside>

<aside> <img src="/icons/shuffle_blue.svg" alt="/icons/shuffle_blue.svg" width="40px" /> Une page au hasard

Untitled

</aside>

Usage de STF_dtf

STF_dtf fait partie des classes de filtres disponibles Ă  partir de la version v1 de la librairie SuperTool ST_filters_init.py :

https://www.dropbox.com/scl/fi/omxfv2jqcwmki4i1y46n0/ST_filters_init.py?rlkey=0js4ymt0tg2dqu4u5em1ecetq&dl=0

Elle fait partie des classes de filtres communs à différents types de vues. Le filtre peut fonctionner dans chacune des vues suivantes : PERSON, EVENT, CITATION, SOURCE, REPOSITORY, NOTE, PLACE, MEDIA, FAMILY

Cette classe permet de filtrer les objets modifiés soit à une date précisée soit à la demande soit à la date du jour.

Il y a deux, ou trois, paramètres à modifier pour sélectionner l’action qui permettra de retourner les résultats.

Exemple d’utilisation

Son usage est simple, il suffit de disposer de SuperTool et de créer un filtre dans une des vues qui l’acceptent en sélectionnant un filtre Generic filter rule dans la catégorie Isotammi filters et de copier-coller les trois informations décrites plus loin dans cette page dans ses trois champs.

Par exemple, le filtre suivant filtre les Individus modifiés après la date qui est demandée par le filtre :

image.png

Celui-ci filtre les individus modifiés aujourd’hui:

image.png

Initial statements

@include ST_filters_init.py

dtf = STF_dtf(
    # Valeurs modifiables - début
        method = ST_TODAY   # valeurs possibles:    ST_GET (permet de spécifier une date dans le paramêtre <a_day>),
                            #                       ST_ASK (ouvre une fenĂŞtre demandant la date Ă  rechercher),
                            #                       ST_TODAY (défaut, date du jour).
        a_day = None        # valeur possible: une date
    # Valeurs modifiables - fin
)

Le paramétrage du filtre s’effectue dans le paramètre method en fonction des valeurs possibles (ST_GET, ST_ASK ou ST_TODAY) et au besoin dans le paramètre a_day si method = ST_GET, dans ce cas la date attendue est à indiquée au format ISO ("YYYY-MM-DD").

Statements

dtf.recherche(namespace=namespace, gramps_id=gramps_id, obj=obj,
# Valeurs modifiables - début
    when = ST_ON    # valeurs possibles:    ST_AFTER (modifié avant la date spécifiée),
                    #                       ST_ON (défaut, modifié à la date spécifiée).
# Valeurs modifiables - fin
)

Le statement permet de sélectionner la recherche d’une modification après la date spécifiée (ST_AFTER) ou le jour même de la date indiquée (ST_ON).

Rule

gramps_id in dtf.gid

Il s’agit là de la sélection du retour du filtrage, il n’y a rien à faire de particulier dans cette partie.

Autres documentations de la librairie ST_filters_init.py

Cette documentation fait partie d’une série de documentations de la librairie ST_filters_init.py. Les documentations déjà rédigées sont listées ci-dessous:

Untitled