Configuration

La configuration du module Link s’effectue dans le fichier config/custom.yaml qui est une surcharge du fichier config/services.yaml Le fichier config/services.yaml ne peut pas être modifié car il est actualisé à chaque nouvelle mise à jour Il est nécessaire de copier le code suivant si vous souhaitez modifier ou adapter la configuration. Vous pouvez copier/coller la partie app.link_config à partir du fichier config/services.yaml mais il est important de renommer app en custom

parameters:
  custom.link_config:
    apps: ["ez_facture_fournisseur", "ez_bl_fournisseur"]
    fields_id: ['ez_facture_fournisseur.EZ_FACTURE_FOURNISSEUR_ID', 'ez_bl_fournisseur.EZ_BL_FOURNISSEUR_ID']
    interface_fournisseur_max_number: 30
    limitgridlines: 10 # Nombre global d'éléments à afficher pour la pagination
    ez_facture_fournisseur:
      title: 'Facture Fournisseur'
      titles: 'Factures Fournisseur'
      title_action: 'Lier la facture'
      title_home_action: 'Lier avec des factures'
      title_button_link: "ne plus proposer ce bon de livraison Fournisseur"
      field_id: 'EZ_FACTURE_FOURNISSEUR_ID'
      qry_all_syskey: 'EZDS001_QRY_FACTURES'
      prefered_app: ez_bl_fournisseur
      limitgridlines: 10
      # Champs pour l'affichage des résultats
      legend1: 'Numéro'
      legend2: 'Date'
      legend3: 'Montant HT'
      field1: 'EZ_FACTURE_FOURNISSEUR_NUMERO_FACTURE'
      field2: 'EZ_FACTURE_FOURNISSEUR_DATE_PIECE'
      field3: 'EZ_FACTURE_FOURNISSEUR_MONTANT_HT'
      format1: ''
      format2: 'date-fr'
      format3: ''
      search:
        # Filtres imposés pouvant être cachés
        field_society: 'EZ_CONTACT_LIB'
        field_date: 'EZ_FACTURE_FOURNISSEUR_DATE_RECEPTION'
        field_user: 'EZ_FACTURE_FOURNISSEUR_SUIVI_SECUSRID'
        field_user_jointure: '_secusr,SECUSR_LOGIN,SECUSR_ID'
        # Filtres personnalisable N°1
        custom1_field:  'EZ_FACTURE_FOURNISSEUR_ETAT_NOM'
        custom1_lib: 'Par état'
        custom1_format: ''
        # Filtres personnalisable N°2
        custom2_field:  'EZ_FACTURE_FOURNISSEUR_DEVISE_NOM'
        custom2_lib: 'Par devise'
        custom2_format: ''
        # Filtres personnalisable N°3
        custom3_field:  'EZ_FACTURE_FOURNISSEUR_MONTANT_TTC'
        custom3_lib: 'Par montant TTC'
        custom3_format: '%0.2f €'
        # Choix des filtres à afficher
        display: ['field_society', 'field_date', 'field_user', 'custom1', 'custom2', 'custom3']
    ez_bl_fournisseur:
      title: 'Bon de livraison Fournisseur'
      titles: 'Bons de livraison Fournisseur'
      title_action: 'Lier ce BL'
      title_home_action: 'Lier avec des bons de livraison'
      field_id: 'EZ_BL_FOURNISSEUR_ID'
      qry_all_syskey: 'EZDS002_QRY_BLS'
      prefered_app: ez_facture_fournisseur
      # Champs pour l'affichage des résultats
      legend1: 'Fournisseur'
      legend2: 'Numéro'
      legend3: 'Date'
      field1: 'EZ_CONTACT_LIB'
      field2: 'EZ_BL_FOURNISSEUR_NUMERO_BL'
      field3: 'EZ_BL_FOURNISSEUR_DATE_PIECE'
      format1: ''
      format2: ''
      format3: 'date-fr' # Format EZDS : date-fr
      field_society: 'EZ_CONTACT_LIB'
      search:
        # Filtres imposés pouvant être cachés
        field_society: EZ_CONTACT_LIB
        field_date: EZ_BL_FOURNISSEUR_DATE_PIECE
        field_user: EZ_BL_FOURNISSEUR_SUIVI_SECUSRID
        display: ['field_society', 'field_date', 'field_user']

apps : permet d’indiquer les applications à proposer pour la liaison de documents. Exemple : Si vous souhaitez proposer uniquement les factures dans la popup, il suffit d’indiquer ceci : apps: ['ez_facture_fournisseur']

fields_id : ce paramètre contient la liste des clés de votre table. Chaque valeur doit contenir le nom de la table ainsi que le nom du champ. Exemple : ez_facture_fournisseur.EZ_FACTURE_FOURNISSEUR_ID

interface_fournisseur_max_number : Correspond au nombre d’enregistrement pour afficher une selectbox à la place de tags. Exemple : interface_fournisseur_max_number: 30 affichera la liste des fournisseurs sous forme de tags tant que le nombre de résultat est inférieur ou égal à 30 Si le nombre est supérieur à 30, une boite à liste sera affichée.

Capture d’écran 2022-11-23 à 08.22.01.png

Capture d’écran 2022-11-23 à 08.22.28.png

Chaque app déclarée dans le paramètre apps doit faire l’objet d’une configuration comme celle-ci :

ez_facture_fournisseur:                                        # Correspond au nom indiqué dans la variable apps
  title: 'Facture Fournisseur'                                 # Titre au singulier
  titles: 'Factures Fournisseur'                               # Titre au pluriel
  title_action: 'Lier la facture'                              # Titre représentant l'action
  title_home_action: 'Lier avec des factures'                  # Titre représentant l'action
  field_id: 'EZ_FACTURE_FOURNISSEUR_ID'                        # Champ clé de la table
  qry_all_syskey: 'EZDS001_QRY_FACTURES'                       # Important : syskey correspondant à la qry contenant toutes les factures à proposer
  prefered_app: ez_bl_fournisseur                              # app préférée à afficher par défaut. Quand on part d'une facture, les bls seront proposés en premier
  limitgridlines: 10                                           # Nombre de factures à afficher pour la pagination
  legend1: 'Numéro'                                            # Légende colonne 1 pour l'affichage des résultats
  legend2: 'Date'                                              # Légende colonne 2 pour l'affichage des résultats
  legend3: 'Montant HT'                                        # Légende colonne 3 pour l'affichage des résultats
  field1: 'EZ_FACTURE_FOURNISSEUR_NUMERO_FACTURE'              # Champ à afficher pour la colonne 1 
  field2: 'EZ_FACTURE_FOURNISSEUR_DATE_PIECE'                  # Champ à afficher pour la colonne 2
  field3: 'EZ_FACTURE_FOURNISSEUR_MONTANT_HT'                  # Champ à afficher pour la colonne 3
  format1: ''                                                  # Des filtres peuvent être appliqués sur la données. Actuellement seulement **date-fr** est disponible
  format2: 'date-fr'                                           # Des filtres peuvent être appliqués sur la données. Actuellement seulement **date-fr** est disponible
  format3: ''                                                  # Des filtres peuvent être appliqués sur la données. Actuellement seulement **date-fr** est disponible
  ~~field_society: 'EZ_CONTACT_LIB'~~                              # Ce champ n'est plus utilisé. Il doit etre renseigné tant qu'il est obligatoire. Dans une prochaine mise à jour, celui-ci sera retiré.
  # Paramètres dédiés à la recherche
  search:
    # Filtres imposés pouvant être cachés
    field_society: EZ_CONTACT_LIB                              # Champ correspondant normalement à la société mais celui-ci peut indiquer un autre champ de votre table: EZ_FACTURE_FOURNISSEUR_ETAT_NOM
    field_date: EZ_FACTURE_FOURNISSEUR_DATE_RECEPTION          # Ce champ doit faire référence à un champ de type Date **obligatoirement**
    field_user: EZ_FACTURE_FOURNISSEUR_SUIVI_SECUSRID          # Ce champ doit faire référence idéalement à la table secusr via la jointure
    field_user_jointure: '_secusr,SECUSR_LOGIN,SECUSR_ID'
    # Filtres personnalisable N°1
    custom1_field:  'EZ_FACTURE_FOURNISSEUR_ETAT_NOM'          # Permet d'indiquer le champ pour le filtre custom1
    custom1_lib: 'Par état'                                    # Permet d'indiquer le titre pour le filtre custom1
    custom1_format: ''                                         # Permet d'indiquer le format à appliquer lors de l'affichage des valeurs. Actuellement seul date-fr et sprintf est pris en compte comme '%0.2f' par exemple
    # Filtres personnalisable N°1
    custom2_field:  'EZ_FACTURE_FOURNISSEUR_DEVISE_NOM'
    custom2_lib: 'Par devise'
    custom2_format: ''
    # Filtres personnalisable N°3
    custom3_field:  'EZ_FACTURE_FOURNISSEUR_MONTANT_TTC'
    custom3_lib: 'Par montant TTC'
    custom3_format: '%0.2f €'
    # Choix des filtres à afficher
    display: ['field_society', 'field_date', 'field_user', 'custom1', 'custom2', 'custom3'] # Permet de décider des filtres à afficher dans la popup

Vous avez la possibilité via les champs CUSTOM d’ajouter vos propres filtres. Il faut simplement que le champ soit inclus dans les champs de la QRY indiquée avec la SYSKEY.

Nouveautés (17/01/2023)

Le header a été refondu afin d’être plus compréhensible. 2 boutons sont maintenant affichés : Lier : permet de lier 2 documents ensembles et le document de droite sera toujours proposé. Lier et ne plus proposer……. : permet de lier les 2 documents mais surtout de ne plus proposer le bon de livraison sélectionné avec d’autres factures. Il sera toujours proposé par exemple avec les devis fournisseur. Un nouveau paramètre a été ajouté pour indiquer le libellé de votre choix sur le nouveau bouton permettant de “lier et ne plus proposer le document” Paramètre : title_button_link Ce paramètre a été ajouté dans le fichier config/services.yaml et vous pouvez l’ajouter dans votre fichier custom.yaml

Capture d’écran 2023-01-17 à 10.29.07.png

Nouveautés (14/03/2023)