Champs personnalisés

Informations générales – Recommandations

La séquence d’appels peut sembler contraignante pour mettre à jour la valeur d’un champ personnalisé, mais les champs personnalisés dans INES proposant de telles possibilité de paramétrage, nous sommes contraints de descendre à ce niveau de détail pour répondre à tous les cas possibles. En effet, un champ personnalisé pouvant être défini en « multiple », si plusieurs valeurs sont présentes pour une société et un champ donné par exemple, il est impératif de connaître l’occurrence de la valeur que vous souhaitez mettre à jour.

La séquence d’appels recommandée est la suivante pour une mise à jour de champ personnalisés société (le mode de fonctionnement pour les champs personnalisés sur les autres type d’éléments est identique) :

– GetCompanyCF : vous retourne la liste des définitions de champs personnalisés disponibles pour la société donnée en paramètre, ainsi que dans l’objet « Values » la liste des valeurs déja présentes pour cette société, champ par champ. Dans ce bloc, identifiez la référence de la valeur que vous souhaitez mettre à jour par la référence du champ, sa valeur si nécessaire (en cas de mise à jour d’un champ multiple par exemple). Attention, cette méthode ne retourne que les informations relatives aux champs définis comme « affichés » sur la fiche société. Pour atteindre l’ensemble des champs personnalisés, qu’ils soient affichés ou non, utilisez la méthode GetCompanyCFWithHidden, son fonctionnement est identique.

Détail en entrée :

  <GetCompanyCF xmlns="http://webservice.ines.fr">
    <reference>int</reference>              -- référence de la société
  </GetCompanyCF>

Objets fournis en résultat :

<CustomField>
    <Ref>int</Ref>                      -- référence de la valeur du champ (DefinitionRef) pour la société
    <DefinitionRef>int</DefinitionRef>  -- référence du champ
    <Group>int</Group>                  -- référence du groupe de champs
    <Value>string</Value>               -- valeur du champ pour la société
    <Name>string</Name>                 -- nom du champ
</CustomField>

– UpdateCompanyCF : passez en paramètre la référence de la société, la référence du champ, la référence de la valeur du champ à mettre à jour

Détail en entrée :

<UpdateOpportCF xmlns="http://webservice.ines.fr">
    <opRef>int</opRef>                  -- référence de la société
    <chdefRef>int</chdefRef>            -- référence du champ
    <chpRef>int</chpRef>                -- référence de la valeur du champ pour la société
    <chpValue>string</chpValue>         -- nouvelle valeur du champ
</UpdateOpportCF>

Objets fournis en résultat :

<UpdateClientCFResult>ok or failed</UpdateClientCFResult>

Si la méthode GetCompanyCF ou GetCompanyCFWithHidden ne retourne aucune valeur pour la société, ou si votre champ est multiple et que vous souhaitez ajouter une nouvelle valeur, vous pouvez appeler la méthode InsertCompanyCF.

Détail en entrée :

<InsertCompanyCF xmlns="http://webservice.ines.fr">
    <chdefRef>int</chdefRef>              -- référence du champ à alimenter
    <clRef>int</clRef>                    -- référence de la société pour laquelle la valeur est saisie
    <chpValue>string</chpValue>           -- valeur du champ personnalisés
    <chvLies>int</chvLies>                -- 0 ou référence du bloc de valeurs dans le cas d'un champ appartenant à un groupe défini en groupe de champs liées
    <chvGroupeAssoc>int</chvGroupeAssoc>  -- 0 ou référence du groupe d'utilisateur dans le cas d'un champ permettant la saisie d'une valeur par groupe d'utilisateur
</InsertCompanyCF>

Objets fournis en résultat :

<InsertCompanyCFResult>ok or failed</InsertCompanyCFResult>

Liste des méthodes disponibles