Comparaison des versions

Légende

  • Ces lignes ont été ajoutées. Ce mot a été ajouté.
  • Ces lignes ont été supprimées. Ce mot a été supprimé.
  • La mise en forme a été modifiée.

...

Webhook un peu particulier qui permet de connaitre les paramètres et limites utilisés par les autres webhooks, ainsi que l’activation des notifications d'échanges.

Utilisation en lecture uniquement.

...

  • sw_data_basevariable : Table des variables

  • sw_sys_confnotification : Table des notifications système

Critères d'activation

WHK_Parameters est défini dans la gestion des webhooks du studio.

Particularités

Pour l'instant trois Les paramètres sont retournés :

  • fileMaxSize : taille maximum en octets des fichiers que l'on peut uploader dans le webhook File. Cette valeur est également retournée dans la réponse du webhook File en mode DEFINITION. La valeur dépend de l’origine de l’appelant :

    • Addin Outlook → Utilisation des variables suivantes par ordre de priorité :

      • Variable AddinOutlookDbFromFileMaxSize (par défaut 5120 Ko)

      • Variable WebhookDbFromFileMaxSize (par défaut 512 Ko)

      • Variable MobileDbFromFileMaxSize (par défaut 512 Ko)

    • Addin Gmail → Utilisation des variables suivantes par ordre de priorité :

      • Variable AddinGmailDbFromFileMaxSize (par défaut 5120 Ko)

      • Variable WebhookDbFromFileMaxSize (par défaut 512 Ko)

      • Variable MobileDbFromFileMaxSize (par défaut 512 Ko)

    • Autre → Utilisation des variables suivantes par ordre de priorité :

      • Variable WebhookDbFromFileMaxSize (par défaut 512 Ko)

      • Variable MobileDbFromFileMaxSize (par défaut 512 Ko)

    • Si aucune variable n’est définie ou que les valeurs sont vides, une sécurité supplémentaire appliquera une limite à 512 Ko

  • maxElementAtOnce (variable Webhook.PUT.MaxElementAtOnce) : pour le mode PUT par lot, permet de définir le nombre maximum d'éléments qui peuvent être passés à la fois dans le tableau de données (par défaut : 10). Cette valeur est également retournée dans la réponse des webhooks en mode PUT.

  • pageSize (variable Webhook.LIST.ElementPerPage) : pour le mode LIST, permet de définir le nombre d'enregistrements à afficher par page (par défaut : 10). Cette valeur est également retournée dans la réponse des webhooks en mode LIST.

Depuis la V6.2, on retourne également l’activation des notifications d'échanges :

  • ExtDataUpdateAsync_Customeraddress : activation de l'échange des adresses des tiers

    • 0 : pas activé

    • 1 : activé

  • ExtDataUpdateAsync_Equipment : activation de l'échange des équipements

    • 0 : pas activé

    • 1 : activé

  • ExtDataUpdateAsync_Intervention : activation de l'échange des interventions

    • 0 : pas activé

    • 1 : activé

  • ExtDataUpdateAsync_Planning : activation de l'échange des planifications

    • 0 : pas activé

    • 1 : activé

  • ExtDataUpdateAsync_ProductstockReplenishmentrequestheader : activation de l'échange des demandes de réapprovisionnement

    • 0 : pas activé

    • 1 : activé

  • ExtDataUpdateAsync_Productstocktransferreceivedheader : activation de l'échange des réceptions des bons de transfert

    • 0 : pas activé

    • 1 : activé

Fonctionnement

Appel du webhook :
Le json d'appel de ce webhook n'a besoin d'aucun paramètre. Un header avec les informations de base est suffisant.

...

Bloc de code
languagejson
"response": {
  "data": 
  [{
    "parameter":
    {
      "fileMaxSize": "524288",
      "maxElementAtOnce": "10",
      "pageSize": "10",
      "ExtDataUpdateAsync_Customeraddress": "1",
      "ExtDataUpdateAsync_Equipment": "1",
      "ExtDataUpdateAsync_Intervention": "1",
      "ExtDataUpdateAsync_Planning": "1",
      "ExtDataUpdateAsync_ProductstockReplenishmentrequestheader": "1",
      "ExtDataUpdateAsync_Productstocktransferreceivedheader": "1"
    }
  }],
  "parameterList": 
  [{
    "parameters": 
    [{
      "parameterName": "fileMaxSize",
      "parameterCode": "WebhookDbFromFileMaxSize",
      "parameterType": "int",
      "parameterLength": "",
      "parameterComment": "Maximum size in bytes of the file that can be uploaded (Size depends of the caller : AddIn Outlook, AddIn Gmail, Other)"
    },
    {
      "parameterName": "maxElementAtOnce",
      "parameterCode": "Webhook.PUT.MaxElementAtOnce",
      "parameterType": "int",
      "parameterLength": "",
      "parameterComment": "Webhook : PUT - Max elements that can be passed at once"
    },
    {
      "parameterName": "pageSize",
      "parameterCode": "Webhook.LIST.ElementPerPage",
      "parameterType": "int",
      "parameterLength": "",
      "parameterComment": "Webhook : LIST - Elements per page"
    },
    {
      "parameterName": "ExtDataUpdateAsync_Customeraddress",
      "parameterCode": "ExtDataUpdateAsync_Customeraddress",
      "parameterType": "bool",
      "parameterLength": "",
      "parameterComment": "Notification activation for sw_data_customeraddress. Insert row in sw_data_externaldataupdateasync for customer address"
    },
    {
      "parameterName": "ExtDataUpdateAsync_Equipment",
      "parameterCode": "ExtDataUpdateAsync_Equipment",
      "parameterType": "bool",
      "parameterLength": "",
      "parameterComment": "Notification activation for sw_data_equipment. Insert row in sw_data_externaldataupdateasync for equipment"
    },
    {
      "parameterName": "ExtDataUpdateAsync_Intervention",
      "parameterCode": "ExtDataUpdateAsync_Intervention",
      "parameterType": "bool",
      "parameterLength": "",
      "parameterComment": "Notification activation for sw_data_intervention. Insert row in sw_data_externaldataupdateasync for intervention"
    },
    {
      "parameterName": "ExtDataUpdateAsync_Planning",
      "parameterCode": "ExtDataUpdateAsync_Planning",
      "parameterType": "bool",
      "parameterLength": "",
      "parameterComment": "Notification activation for sw_data_planning. Insert row in sw_data_externaldataupdateasync for planning"
    },
    {
      "parameterName": "ExtDataUpdateAsync_ProductstockReplenishmentrequestheader",
      "parameterCode": "ExtDataUpdateAsync_ProductstockReplenishmentrequestheader",
      "parameterType": "bool",
      "parameterLength": "",
      "parameterComment": "Notification activation for sw_data_productstockreplenishmentrequestheader. Insert row in sw_data_productstockreplenishmentrequestheader for header of replenishment request"
    },
    {
      "parameterName": "ExtDataUpdateAsync_Productstocktransferreceivedheader",
      "parameterCode": "ExtDataUpdateAsync_Productstocktransferreceivedheader",
      "parameterType": "bool",
      "parameterLength": "",
      "parameterComment": "Notification activation for sw_data_productstocktransferreceivedheader. Insert row in sw_data_externaldataupdateasync for header of received transfer"
    }]
  }]
}