Interface: HRMS - Données mouvements objets version 2017.10

Ce document décrit l'interface AbaConnect Données mouvements objets de l'application HRMS .


Informations générales

Informations générales sur l'interface.

Information de l'interface AbaConnect
Application:HRMS
Nom de l'interface:Données mouvements objets
ID:ObjectAssignmentData ( ObjectAdministration )
Version:2017.10
Status:Productif


Fonctions d'exportation et d'importation possibles de l'interface

Fonctions exportation/importation
Exportation:XML
Importation:XML


Informations complémentaires sur l'interface

Information complémentaire

                                  Révision champ Maximum de l'interface : 1



Informations de mappage

Les informations relatives au mappage sont affichées ci-dessous.

Informations de mappage
ID mappage:AbaDefault
Nom du mappage:Données mouvements objets
Description:
Insérer (Insert):
Avec Insert, le champ Numéro d'écriture (BookINumber) ne doit pas être activé car ce numéro continu est attribué automatiquement.
Il est possible de référencer l'objet à éditer soit via l'ID objet (ObjectID) soit via le numéro d'objet (ObjectNumber).  
Il est recommandé d'utiliser l'ID objet (ObjectID) car cette ID ne peut pas être modifiée. 
Le numéro d'objet (ObjectNumber) est exclusif mais peut être modifié. 
Si l'ID objet (ObjectID) et le numéro d'objet (ObjectNumber) sont indiqués, ils doivent faire référence au même objet. 
Si ce n'est pas le cas, un message d'erreur est édité.

Actualiser (Update):
Avec Update, le champ Numéro d'écriture (BookINumber) doit être activé. Tous les autres champs sont facultatifs. Cela signifie que les champs qui doivent être modifiés (par ex. Champ Édition (Issue)), doivent être remplis. 
Si le numéro d'écriture (BookINumber) n'est pas valable, un message d'erreur apparaît.

Supprimer (Delete):
Avec Delete, le champ Numéro d'écriture (BookINumber) doit être activé. Tous les autres champs sont facultatifs et seront ignorés pendant le traitement de la transaction.

Enregistrer (Save):
Save est identique à Insert ou Update, selon les champs remplis.
Si Save est choisi sans numéro d'écriture (BookINumber), s'en suit Insert.
Si Save est choisi avec numéro d'écriture (BookINumber), s'en suit Update.



Exemple d'une structure XML AbaConnect

Ci-dessous un exemple d'une structure Header XML. Cette information est donc visible dans un fichier d'exportation XML AbaConnect, fichier exporté via l'interface AbaConnect Abacus.

Structure XML AbaConnect
<?xml version='1.0' encoding='UTF-8'?>
<AbaConnectContainer>
  <TaskCount>1</TaskCount>
  <Task>
    <Parameter>
      <Application>HRMS</Application>
      <Id>ObjectAssignmentData</Id>
      <MapId>AbaDefault</MapId>
      <Version>2017.10</Version>
      <!-- Attention: Le numéro de mandant est facultatif et signifie que les données ne peuvent être importées que dans le mandant spécifié -->
      <!-- L'option mandant a un effet uniquement lors de l'importation des données. Configuration possible dans les paramètres d'exportation AbaConnect. -->
      <!-- Par défaut, le numéro de mandant n'est pas écrit dans le fichier d'exportation -->
      <Mandant>7777</Mandant>
    </Parameter>
    <Transaction>
      <ObjectAssignmentData mode='SAVE'>
          <!-- Les champs spécifiques des données pour l'interface AbaConnect peuvent être définis ici. -->
      </ObjectAssignmentData>
    </Transaction>
  </Task>
</AbaConnectContainer>



Exemple AbaConnect Command Line

Voici quelques exemples de la ligne de commande AbaConnect. La ligne de commande AbaConnect peut être exécutée avec les programmes abaconnectexportconsole.exe et abaconnectimportconsole.exe. La ligne de commande AbaConnect doit être exécutée directement sur le serveur. Vous trouverez de plus amples informations sur la page d'accueil d'Abacus. Les exemples suivants servent de point de départ pour la création d'une ligne de commande simple.

AbaConnect Command Line
Export :
abaconnectexportconsole.exe "/USRuser" "/PWxxx"  "-aHRMS"  "-version2017.10"  "-M7777"  "-acidObjectAssignmentData"  "-mapidAbaDefault"  "-datamodeXML"  "-responseYES"  "-responsefileX:\response.xml"  "-exportfileX:\data.xml"

Import :
abaconnectimportconsole.exe "/USRuser" "/PWxxx"  "-aHRMS"  "-version2017.10"  "-M7777"  "-datamodeXML"  "-responseYES"  "-responsefileX:\response.xml"  "-importfileX:\data.xml"

N.B. : Pour importer des données XML, il n'est pas nécessaire de spécifier l'ID d'interface et le mappage dans la Command Line. Cette information se trouve dans le fichier d'importation XML.



Champs / structure du mappage

La table suivante affiche les données du mappage de manière simplifiée.
Le nom de l'élément XML et du parent est toujours écrit en anglais. Avec un clic de la souris sur une ligne, des informations supplémentaires sont affichées.

Nom élément XML Nom du champ Nom parent Type Longueur Obligatoire
ObjectAssignmentDataÉcriture---Oui
    - BookNumberN° écritureObjectAssignmentDataNuméro14Non
    - ObjectIDObjet IDObjectAssignmentDataNuméro8Non
    - ObjectNumberNuméro objetObjectAssignmentDataNuméro10Non
    - CopyNumberExemplaireObjectAssignmentDataNuméro12Non
    - CopyIDExemplaire IDObjectAssignmentDataTexte100Non
    - AddressNumberAdresseObjectAssignmentDataNuméro10Non
    - IssueDateRemiseObjectAssignmentDataDate-Non
    - ReturnDateRestitutionObjectAssignmentDataDate-Non
    - UsageFeeTaxe utilisationObjectAssignmentDataNuméro6Non
    - DepositFeeDeposit feeObjectAssignmentDataNuméro6Non
    - Text1Texte 1ObjectAssignmentDataTexte100Non
    - Text2Texte 2ObjectAssignmentDataTexte100Non
    DossierDossierObjectAssignmentData--Non
        - NameNom du dossierDossierTexte50Non
        - DescriptionDescriptionDossierTexte200Non
        - DocumentIDNuméro explicite du documentDossierTexte36Non
        - FileNameNom du fichier pour cette transactionDossierTexte-1Non
        - OriginalFileNameNom d'origine du fichierDossierTexte-1Non
    FreeFieldsChamps libresObjectAssignmentData--Non
        FreeFieldValueValeur des champs libresFreeFields--Non
            - IdFreeFieldValueTexte-1Oui
            - ValueFreeFieldValueTexte-1Oui
    - NoteNoteObjectAssignmentDataTexte-1Non



Informations détaillées des champs

Description détaillée des champs de l'interface.

N° écriture
Nom élément XML:BookNumber
Elément parent:ObjectAssignmentData
Type de champ:Numéro
Type d'action:Importation et exportation
Longueur champ:   14Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   1
Description:

                                  (Le champ ID internes pour cet élément est "BookId")
                    

Objet ID
Nom élément XML:ObjectID
Elément parent:ObjectAssignmentData
Type de champ:Numéro
Type d'action:Importation et exportation
Longueur champ:   8Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   2
Description:

                                  (Le champ ID internes pour cet élément est "ObjectId")
                    

Numéro objet
Nom élément XML:ObjectNumber
Elément parent:ObjectAssignmentData
Type de champ:Numéro
Type d'action:Importation et exportation
Longueur champ:   10Décimales:   0Champ obligatoire:   NonRévision:   1ID Ascii:   14
Description:

                                  (Le champ ID internes pour cet élément est "ObjectNr")
                    

Exemplaire
Nom élément XML:CopyNumber
Elément parent:ObjectAssignmentData
Type de champ:Numéro
Type d'action:Importation et exportation
Longueur champ:   12Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   3
Description:

                                  (Le champ ID internes pour cet élément est "Copy")
                    

Exemplaire ID
Nom élément XML:CopyID
Elément parent:ObjectAssignmentData
Type de champ:Texte
Type d'action:Importation et exportation
Longueur champ:   100Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   15
Description:

                                  (Le champ ID internes pour cet élément est "CopyId")
                    

Adresse
Nom élément XML:AddressNumber
Elément parent:ObjectAssignmentData
Type de champ:Numéro
Type d'action:Importation et exportation
Longueur champ:   10Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   4
Description:

                                  (Le champ ID internes pour cet élément est "AddressNr")
                    

Remise
Nom élément XML:IssueDate
Elément parent:ObjectAssignmentData
Type de champ:Date (2000-03-20)
Type d'action:Importation et exportation
Longueur champ:   -Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   5
Description:

                                  (Le champ ID internes pour cet élément est "Issue")
                    

Restitution
Nom élément XML:ReturnDate
Elément parent:ObjectAssignmentData
Type de champ:Date (2000-03-20)
Type d'action:Importation et exportation
Longueur champ:   -Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   6
Description:

                                  (Le champ ID internes pour cet élément est "Back")
                    

Taxe utilisation
Nom élément XML:UsageFee
Elément parent:ObjectAssignmentData
Type de champ:Numéro
Type d'action:Importation et exportation
Longueur champ:   6Décimales:   2Champ obligatoire:   NonRévision:   0ID Ascii:   7
Description:

                                  (Le champ ID internes pour cet élément est "UsageFee")
                    
Un point doit être utilisé comme séparateur de décimales selon la définition de W3C pour le XML Standard.

Deposit fee
Nom élément XML:DepositFee
Elément parent:ObjectAssignmentData
Type de champ:Numéro
Type d'action:Importation et exportation
Longueur champ:   6Décimales:   2Champ obligatoire:   NonRévision:   0ID Ascii:   8
Description:

                                  (Le champ ID internes pour cet élément est "DepositeFee")
                    
Un point doit être utilisé comme séparateur de décimales selon la définition de W3C pour le XML Standard.

Texte 1
Nom élément XML:Text1
Elément parent:ObjectAssignmentData
Type de champ:Texte
Type d'action:Importation et exportation
Longueur champ:   100Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   9
Description:

                                  (Le champ ID internes pour cet élément est "Text1")
                    

Nom du dossier
Nom élément XML:Name
Elément parent:Dossier
Type de champ:Texte
Type d'action:Importation et exportation
Longueur champ:   50Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   1
Description:

                                  (Le champ ID internes pour cet élément est "Name")
                    

Description
Nom élément XML:Description
Elément parent:Dossier
Type de champ:Texte
Type d'action:Importation et exportation
Longueur champ:   200Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   2
Description:

                                  (Le champ ID internes pour cet élément est "Description")
                    

Numéro explicite du document
Nom élément XML:DocumentID
Elément parent:Dossier
Type de champ:Texte
Type d'action:Importation et exportation
Longueur champ:   36Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   3
Description:

                                  (Le champ ID internes pour cet élément est "DID")
                    

Nom du fichier pour cette transaction
Nom élément XML:FileName
Elément parent:Dossier
Type de champ:Texte
Type d'action:Importation et exportation
Longueur champ:   -1Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   4
Description:

                                  (Le champ ID internes pour cet élément est "Filename")
                    

Nom d'origine du fichier
Nom élément XML:OriginalFileName
Elément parent:Dossier
Type de champ:Texte
Type d'action:Importation et exportation
Longueur champ:   -1Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   5
Description:

                                  (Le champ ID internes pour cet élément est "OriginalFilename")
                    

Texte 2
Nom élément XML:Text2
Elément parent:ObjectAssignmentData
Type de champ:Texte
Type d'action:Importation et exportation
Longueur champ:   100Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   10
Description:

                                  (Le champ ID internes pour cet élément est "Text2")
                    

Valeur des champs libres
Nom élément XML:FreeFieldValue
Elément parent:FreeFields
Type de champ:Linked List
Type d'action:Importation et exportation
Longueur champ:   -Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   1
Description:

                                  (Le champ ID internes pour cet élément est "SstExtendedFieldData")
                    

Nom élément XML:Id
Elément parent:FreeFieldValue
Type de champ:Texte
Type d'action:Importation et exportation
Longueur champ:   -1Décimales:   0Champ obligatoire:   OuiRévision:   0ID Ascii:   1
Description:

                                  (Le champ ID internes pour cet élément est "Id")
                    

Nom élément XML:Value
Elément parent:FreeFieldValue
Type de champ:Texte
Type d'action:Importation et exportation
Longueur champ:   -1Décimales:   0Champ obligatoire:   OuiRévision:   0ID Ascii:   2
Description:

                                  (Le champ ID internes pour cet élément est "Value")
                    

Dossier
Nom élément XML:Dossier
Elément parent:ObjectAssignmentData
Type de champ:ID
Type d'action:Importation et exportation
Longueur champ:   -Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   11
Description:

                

Champs libres
Nom élément XML:FreeFields
Elément parent:ObjectAssignmentData
Type de champ:ID
Type d'action:Importation et exportation
Longueur champ:   -Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   12
Description:

                

Note
Nom élément XML:Note
Elément parent:ObjectAssignmentData
Type de champ:Texte
Type d'action:Importation et exportation
Longueur champ:   -1Décimales:   0Champ obligatoire:   NonRévision:   0ID Ascii:   13
Description:

                                  (Le champ ID internes pour cet élément est "Note")