ModificationChampSalarie
  • 23 Aug 2024
  • 1 Minute à lire
  • Sombre
    Lumière
  • PDF

ModificationChampSalarie

  • Sombre
    Lumière
  • PDF

Résumé de l’article

Fonction API

/v1/SalarieEmplois/ModificationChampSalarie

Verbe HTTP

Post

Description

Permet de modifier des informations de la fiche salarié. Pour faire un parallèle avec la fonction de lecture LectureInformationsPaie, les champs modifiables correspondent aux champs des tables "PAISALARIE", "INTERVENANT" et "PAISALARIEEMPLOI".
Les champs principaux de la fiche salarié sont décrits dans les fiches annexes Fiche Salarié - Informations salarié, Fiche Salarié - Emploi.

Dans le cas où la mise à jour des champs s'effectue correctement, seule la valeur null est renvoyée. Si un champ est en erreur, un message d'erreur sera généré et aucun champ ne sera mis à jour.

Par ailleurs, il est recommandé d'utiliser la requête CreationSalarieEmploi dans un usage standard et d'utiliser la fonction ModificationChampSalarie uniquement pour des modifications à la marge.

Groupe de fonctions API

MODIF01

Paramètres de la requête

ParamètreTypeDescription
identifiantEmploiinteger(int32)Identifiant de l'emploi concerné, s'il s'agit d'une modification liée à un emploi
listeChampsModificationChampValeursTypees[]Liste d'éléments structurés contenant les informations des champs à modifier (cf. détail ci-dessous)
matriculestringMatricule du salarié concerné
numeroDossierstring

Numéro du dossier concerné par la requête

ModificationChampValeursTypees

ParamètreTypeDescription
nomChampstringNom du champ à modifier
typeValeurstringIndique lequel des paramètres ValeurXXX (valeur correspondante) doit être pris en compte :
Type de valeurValeur correspondante
IntegerInt32
Doubledouble
Stringstring
DateTimedatetime
Unsigned Bytebyte
Booléenbool
Dans le cas où ce paramètre n'est pas valorisé, le champ est mis à jour avec la valeur NULL (valeur existante effacée)
valeurINT32integer(int32)Contient la valeur d'un champ int
valeurDOUBLEnumber(double)Contient la valeur d'un champ double
valeurSTRINGstringContient la valeur d'un champ string
valeurDATETIMEstring(date-time)Contient la valeur d'un champ DateTime
valeurBYTEinteger(int32)Contient la valeur d'un champ unsignedByte
valeurBOOLbooleanContient la valeur d'un champ boolean

Paramètres de la réponse

ParamètreTypeDescription
nomChampstringNom du champ en erreur
valeurobjectValeur associée au champ

Requête

{
  "identifiantEmploi": 0,
  "listeChamps": [
    {
      "nomChamp": "string",
      "typeValeur": "string",
      "valeurINT32": 0,
      "valeurDOUBLE": 10.5,
      "valeurSTRING": "string",
      "valeurDATETIME": "2020-10-14T21:46:24",
      "valeurBYTE": 0,
      "valeurBOOL": true
    },
    {
      "nomChamp": "string",
      "typeValeur": "string",
      "valeurINT32": 0,
      "valeurDOUBLE": 10.5,
      "valeurSTRING": "string",
      "valeurDATETIME": "2020-10-14T21:46:24",
      "valeurBYTE": 0,
      "valeurBOOL": true
    }
  ],
  "matricule": "string",
  "numeroDossier": "string"
}

Réponse

{
  "nomChamp": "string",
  "valeur": null
}

Messages d'erreur

ErreurMessageDescription
Code : "1000"Could not convert string to integer: 10.5. Path 'listeChamps[0].valeurINT32', line 7, position 27.Dans cet exemple de message d'erreur la valeur attendue est une valeur entière et non décimale.

Cet article vous a-t-il été utile ?

Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.