<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_refcount_is

STF_refcount_is 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 Ă  tous les types de vues. Le filtre peut fonctionner dans chacune des vues suivantes : Person, Source, Event, Citation, Repository, Note, Place, Media, Family

Cette classe permet de filtrer les objets qui incorporent un objet ayant un nombre donné de références.

Il y a trois paramètres à modifier pour 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 citations dont une au moins des notes est associée à plus d’une référence:

image.png

Initial statements

    @include ST_filters_init.py

    rrefCount = STF_refcount_is(
        #Valeurs modifiables - début
            nb_obj = 1,                  # Nombre de références à trouver
            count_type = ST_GREATER_THAN # valeurs possibles: ST_LESS_THAN, ST_GREATER_THAN, ST_EQUAL_TO
        #Valeurs modifiables - fin
    )

Le paramétrage du filtre s’effectue en indiquant le nombre de références à trouver et si la valeur trouvée doit être plus grande, plus petite ou égale à ce nombre.

Statements

    rrefCount.recherche(namespace=namespace, gramps_id=gramps_id,
        #Valeurs modifiables - début
            obj_to_count = notes # Type d'objet à compter (dépend de ce que propose la vue, ici les notes)
        #Valeurs modifiables - fin
    )

Une seconde information est à indiquer ici, il s’agit du type d’objet dont on cherche à compter le nombre de références. Ici le type d’objet est celui des Notes.

Rule

    gramps_id in rrefCount.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

<aside> <img src="/icons/arrow-turn-left_blue.svg" alt="/icons/arrow-turn-left_blue.svg" width="40px" /> Retour au blog Ma généalogie avec Gramps

</aside>