Que fait Sarra Semina ?
Sarra Semina a été conçu pour aider les abonnés de Sarracenia à créer leurs règles de configurations.
Sarra Semina facilite l'expérimentation et la mise au point de configurations Sarracenia afin de recevoir les messages désirés. Il permet entre autres de visualiser la liste des messages qu'émettra Sarracenia selon une configuration donnée.
Catalogues de données
La liste des catalogues de données est mise à jour quotidiennement.
Chaque catalogue contient la liste de plusieurs millions de fichiers répartis dans plus de 100,000 répertoires. Considérant ce volume de données, il est avantageux de préciser le plus possible le ou les sous-thèmes recherchés. Une recherche effectuée avec un sous-thème restrinct donnera des résultats rapidement (voir instantannément), alors qu'un sous-thème générique pourra prendre plusieurs minutes, sans compter le risque de saturer la mémoire.
Règles de configuration
Deux types de filtres (règles) sont appliqués sur un catalogue de données :
- Les règles AMQP sont appliqués aux sous-thèmes
- Les filtres Regex sont appliqués en cascade sur les résultats du filtre précédent
Références
Projet GitHub : https://github.com/MetPX/sarrasemina
Documentation : Sarra Semina
What does Sarra Semina do?
Sarra Semina was developed to help Sarracenia's subscribers create their configuration rules.
Sarra Semina facilitates experimentation and development of Sarracenia's configurations in order to receive the desired messages. Among other things, it allows to view a list of messages that Sarracenia will send according to a given configuration.
Data Catalogs
The list of data catalogs is updated daily.
Each catalog contains a list of several million files spread across more than 100,000 directories. Considering this volume of data, it is advantageous to pinpoint as much as possible the subtopic sought. Searches performed with a narrower subtopic will yield results quickly (even instantaneously), while generic ones may take several minutes, not to mention the risk of memory overload.
Configuration rules
Two types of filters (rules) are applied to a data catalog:
- AMQP filters are applied to subtopics
- Regex filters are applied in cascade order on previous filter's results
References
Projet GitHub : https://github.com/MetPX/sarrasemina
Documentation : Sarra Semina
Ce menu déroulant affiche les catalogues des 5 derniers jours précédents aujourd'hui.
Il devrait y avoir peu de différences entre les types de produits disponibles d'un catalogue à l'autre.
Vous pouvez cependant comparer vos résultats de recherche entre des catalogues pour une configuration donnée.
Cette option permet également d'être utilisée comme une machine à remontrer les 5 derniers jours
et à télécharger un fichier qui ne serait plus disponible à partir de Sarracenia.
This drop-down menu displays the catalogs of the last 5 days preceding today.
There should be little difference in the types of available products from one catalog to another.
However, if you need to, you can compare your search results between catalogs for a given configuration.
This option can also be used as a wayback machine of the last 5 days
and to download a file that would no longer be available from Sarracenia.
Ce bouton donne accès à des exemples pré-établis de configuration Sarracenia.
Vous pouvez charger ceux-ci dans l'éditeur d'abonnements afin d'observer les résultats de recherche anticipés sur un catalogue de produits.
Pour procéder, cliquez sur le bouton Configurations et sélectionnez dans la liste une configuration désirée, puis lancez la recherche en cliquant sur le bouton Chercher.
This button gives access to Sarracenia configuration examples.
You can upload a config to the Subscription editor to get its expected results from a product's catalog.
To configure, click on the Configurations button and select a desired config from the list, then launch the search with Search button.
Efface la dernière configuration utilisée et recharge la page.
Clears the last configuration used and reloads the page.
Les filtres de Sarracenia sont sensibles à la casse (Majuscules / minuscules).
Réf.: https://github.com/MetPX/sarracenia/blob/master/doc/fr/sr_subscribe.1.rst#syntaxe-des-options
SarraSemina offre l'option Casse insensible uniquement pour faciliter la recherche de produits.
Par exemple, lorsque vous ne savez pas dans quelles sources rechercher des produits.
Veuillez donc garder ce détail à l'esprit quand cette option activée.
Si vous cherchez des produits avec l'option Casse insensible cochée, il est recommandé de confirmer vos résultats de recherche en désactivant l'option et en lançant la recherche à nouveau pour vérifier si les produits désirés sont toujours présents.
Sarracenia's filters are case sensitive (upper / lower case).
Ref.: https://github.com/MetPX/sarracenia/blob/master/doc/sr_subscribe.1.rst#client-side-filtering
SarraSemina offers the Case insensitive option only to facilitate your search for products.
For example, when you do not know in which sources to look for products.
Please keep this in mind when the option is enabled.
If you are looking for products with the Case insensitive option enabled, you should validate your results by disabling the option and proceed with the search again in order to confirm that found products are still the ones you're looking for.
Il existe deux protocoles AMQP : Post et Report.
v02 est la version/format du protocole de messages Sarracenia.
Le protocole v02.post est celui sélectionné par défaut.
There are two AMQP protocols: Post and Report.
v02 is the version / format of the Sarracenia message protocol.
The v02.post protocol is the one selected by default.
Les Sous-thèmes utilisent les règles AMQP comme filtre.
Les métacaractères permis de AMQP
- Le point ( . ) correspond toujours à un séparateur de répertoire ( / )
- L'étoile ( * ) correspond à tout nom de répertoire
- Le dièse ( # ) correspond à tout caractère du chemin d'un fichier
Règles AMQP
- Ces règles sont sensibles à la casse et sont appliquées au catalogue sélectionné.
- Le filtre AMQP ne peut jamais commencer par un point ( . )
- L'étoile est utilisée uniquement entre deux points ( .*. )
sauf si c'est le premier caractère du filtre ( *. )
- Le dièse est toujours précédé d'un point ( .# )
sauf si c'est le premier caractère du filtre ( # )
Il y a plusieurs manières de personnaliser les règles AMQP de ce champ.
Ajouter :
- Saisir du texte directement dans le champ en respectant les règles AMQP
- Sélectionner un ou plusieurs répertoires dans le menu déroulant du champ Sous-thème
- Cliquer sur un ou plusieurs répertoires dans la liste située plus bas dans la page
Modifier :
- Placer le curseur à la fin d'une règle à l'aide les flèches gauche-droite
- Appuyez sur la touche [Retour en arrière]
- Modifier le texte selon vos besoins
Effacer :
- Effacer tous les filtres avec le grand [X] rouge à la droite du champ
- Cliquer sur le [x] à la droite d'une règle
- Cliquer sur un ou plusieurs filtres et utiliser la touche effacement
Subtopics use AMQP rules as filter.
Wildcards allowed by AMQP
- The dot ( . ) always match a directory separator ( / )
- The star ( * ) matches any directory name
- The sharp ( # ) matches any file's path character
AMQP rules
- These rules are case sensitive and are appliyed to the selected catalogue.
- The AMQP filter can never start with a dot ( . )
- The star wildcard can only be used between two dots ( .*. )
unless it's the begining character of the filter ( *. )
- The sharp wildcard is always preceded by a period ( .# )
unless it's the begining character of the filter ( # )
There are several ways to customize the AMQP rules for this field.
Add :
- Enter text directly in the field in accordance with the rules AMQP
- Select one or more directories from the drop down menu Sub-topic field
- Click on one or more directories in the list further down the page
Modify :
- Position the caret at the end of a rule using left and right arrows to navigate
- Hit Backspace key
- Modify text to meet your needs
Delete :
- Clear all filters with large red [X] at the end of the field
- Click the [x] on the right of a rule
- Click on one or more filters and use the delete key
Tout comme les règles AMQP, les filtres Regex sont sensibles à la casse.
La recherche est effectuée d'un filtre à l'autre en cascade de haut en bas.
Ce filtre détecte et applique des expressions régulières (Regex) sur la liste des éléments reçus du filtre précédent au-dessus de lui.
Il y a deux modes d'opération pour ce filtre : Accepter ou Rejeter.
Like the AMQP rules, Regex filters are case sensitive.
The search operation is performed from one filter to another cascading from top to bottom.
This filter detects and applies regular expressions (Regex) on the received list of items. That list comes from the previous filter above it.
There are two modes of operation for this filter : Accept or Reject.
Ce filtre s'applique aux produits non capturés par les filtres de recherche précédents.
Il n'y a que deux choix pour ce filtre :
Accepter ou Rejeter ces autres produits.
This filter applies to all products that were not captured by previous search filters.
There are only two choices for this filter:
Accept or Reject those other products.