Utilisation correcte des types de données et des conversions de types

Éviter les pièges des conversions de type

Objective

After completing this lesson, you will be able to évitez les pièges des conversions de type.

Affectations réussies

Dans ABAP, vous êtes autorisé à effectuer des valorisations entre des variables de différents types de données. Dans ce cas, ABAP tente de convertir la valeur de la zone source dans le type de la zone cible. La réussite de la conversion dépend de la compatibilité de la valeur de la zone source avec le type de données de la zone cible.

Dans le premier exemple, nous essayons d'affecter la valeur d'une chaîne à une zone de nombre entier. Comme la valeur de la chaîne 12345 est un nombre entier valide, l'affectation est correcte. La deuxième affectation est également réussie.

Essayer - Affectations réussies

  1. Créez une nouvelle classe qui implémente l'interface IF_OO_ADT_CLASSRUN.
  2. Copiez le code suivant dans l'éditeur entre les instructions METHOD if_oo_adt_classrun~main. et ENDMETHOD. :
    Code Snippet
    1234567891011121314151617181920
    DATA var_string TYPE string. DATA var_int TYPE i. DATA var_date TYPE d. data var_pack type p length 3 decimals 2. var_string = `12345`. var_int = var_string. out->write( 'Conversion successful' ). var_string = `20230101`. var_date = var_string. out->write( |String value: { var_string }| ). out->write( |Date Value: { var_date date = user }| ).
  3. Activez la classe en appuyant sur Ctrl + F3.
  4. Jouez avec le code pour vous familiariser avec le sujet.

Affectations échouées

Les conversions de types dans les valorisations ne sont pas toujours réussies. Parfois, la valeur source est incompatible avec le type de la zone cible. Les deux affectations affichées ici entraînent toutes deux des exceptions qui, si elles ne sont pas interceptées, entraînent à leur tour des erreurs d'exécution.

Lorsque vous essayez d'affecter la valeur de chaîne ABCDE à une zone de nombre entier, le système reconnaît que le contenu de la chaîne ne peut pas être représenté sous forme de nombre et déclenche l'exception CX_SY_CONVERSION_NO_NUMBER. Dans le deuxième exemple, nous essayons d'affecter la valeur 1000 à un nombre condensé avec une longueur de 3 et 2 décimales. La variable a donc 5 chiffres, dont deux décimales et donc une valeur maximale de 999,99. L'affectation entraîne donc un débordement arithmétique et le système répond avec l'exception CX_SY_CONVERSION_OVERFLOW.

Troncature et arrondi

Certaines affectations entraînent une perte de données ou d'exactitude. Si, par exemple, vous affectez la valeur d'une zone de caractères à une zone plus courte, la valeur sera tronquée. Dans l'exemple, nous avons essayé d'affecter 5 caractères à une zone de 3 caractères. Dans ce cas, les quatrième et cinquième caractères sont perdus.

Si vous affectez une valeur à une zone numérique et que le nombre de décimales dans la zone cible est insuffisant, le système utilise l'arrondi arithmétique. Dans les deux exemples, un quart peut être représenté précisément comme 0,25, mais un huitième - 0,125 - est arrondi à 0,13.

Essayer - Troncation et arrondi

  1. Créez une nouvelle classe qui implémente l'interface IF_OO_ADT_CLASSRUN.
  2. Copiez le code suivant dans l'éditeur entre les instructions METHOD if_oo_adt_classrun~main. et ENDMETHOD. :
    Code Snippet
    1234567891011121314151617181920
    DATA long_char TYPE c LENGTH 10. DATA short_char TYPE c LENGTH 5. DATA result TYPE p LENGTH 3 DECIMALS 2. long_char = 'ABCDEFGHIJ'. short_char = long_char. out->write( long_char ). out->write( short_char ). result = 1 / 8. out->write( |1 / 8 is rounded to { result NUMBER = USER }| ).
  3. Activez la classe en appuyant sur Ctrl + F3.
  4. Jouez avec le code pour vous familiariser avec le sujet.

Résultats inattendus des affectations

Parfois, le résultat d'une affectation entre deux types de données différents peut sembler inattendu. Par exemple, si vous affectez une zone de date à une zone de nombre entier, la valeur est le nombre de jours depuis le 01/01/0001. De même, si vous affectez une zone de temps à un nombre entier, le résultat est le nombre de secondes depuis minuit.

Si vous affectez une zone de caractères ou une chaîne de caractères à une variable de type N, le système rejette tous les caractères qui ne sont pas des chiffres, organise les chiffres restants alignés à droite dans la zone et renseigne les espaces restants avec des zéros non significatifs.

D'un point de vue technique, une zone de date est une zone de caractères. Vous pouvez donc affecter des valeurs à des zones de date dans ABAP qui ne correspondent pas à une date valide (notez que cela ne peut pas se produire lorsque l'utilisateur saisit des dates via l'IU, car la couche IU valide la date).

Pièges des déclarations en ligne

Lorsque vous utilisez des déclarations en ligne dans des expressions arithmétiques, le système dérive le type de la nouvelle variable du côté droit de l'expression. Comme les littéraux numériques 5 et 10 sont des entiers, les variables result1 et result2 sont également créées en tant qu'entiers. Bien que le résultat de la multiplication soit correct, le résultat de la division est arrondi à 1.

Essayer - Résultats inattendus des affectations

  1. Créez une nouvelle classe qui implémente l'interface IF_OO_ADT_CLASSRUN.
  2. Copiez le code suivant dans l'éditeur entre les instructions METHOD if_oo_adt_classrun~main. et ENDMETHOD. :
    Code Snippet
    123456789101112131415161718192021
    DATA var_date TYPE d. DATA var_int TYPE i. DATA var_string TYPE string. DATA var_n TYPE n LENGTH 4. var_date = cl_abap_context_info=>get_system_date( ). var_int = var_date. out->write( |Date as date| ). out->write( var_date ). out->write( |Date assigned to integer| ). out->write( var_int ). var_string = `R2D2`. var_n = var_string. out->write( |String| ). out->write( var_string ). out->write( |String assigned to type N| ). out->write( var_n ).
  3. Activez la classe en appuyant sur Ctrl + F3.
  4. Jouez avec le code pour vous familiariser avec le sujet.

Conversions de type forcé

Visionnez cette vidéo pour savoir comment forcer les conversions de type explicitement et implicitement.

Essayer - Conversions de type forcé

  1. Créez une nouvelle classe qui implémente l'interface IF_OO_ADT_CLASSRUN.
  2. Copiez le code suivant dans l'éditeur entre les instructions METHOD if_oo_adt_classrun~main. et ENDMETHOD. :
    Code Snippet
    1234567891011121314151617181920212223
    * result has type C. * and is displayed unformatted in the console DATA(result1) = '20230101'. out->write( result1 ). * result2 is forced to have type D * and is displayed with date formatting in the console DATA(result2) = CONV d( '20230101' ). out->write( result2 ). * The method do_something( ) has an importing parameter of type string. * Attempting to pass var results in a syntax error * The CONV #( ) expression converts var into the expected type * Note that CONV #( ) can lead to conversion exceptions * lcl_class=>do_something( var ).
  3. Activez la classe en appuyant sur Ctrl + F3.
  4. Jouez avec le code pour vous familiariser avec le sujet.

Prévention de la troncature et de l'arrondi

Regardez cette vidéo pour savoir comment empêcher la troncature et l'arrondi.

Essayer - Prévention de la troncature et de l'arrondi

  1. Créez une nouvelle classe qui implémente l'interface IF_OO_ADT_CLASSRUN.
  2. Copiez le code suivant dans l'éditeur entre les instructions METHOD if_oo_adt_classrun~main. et ENDMETHOD. :
    Code Snippet
    12345678910111213141516171819202122232425262728293031323334353637383940414243444546
    DATA var_date TYPE d. DATA var_pack TYPE p LENGTH 3 DECIMALS 2. DATA var_string TYPE string. DATA var_char TYPE c LENGTH 3. var_pack = 1 / 8. out->write( |1/8 = { var_pack NUMBER = USER }| ). TRY. var_pack = EXACT #( 1 / 8 ). CATCH cx_sy_conversion_error. out->write( |1/8 has to be rounded. EXACT triggered an exception| ). ENDTRY. var_string = 'ABCDE'. var_char = var_string. out->write( var_char ). TRY. var_char = EXACT #( var_string ). CATCH cx_sy_conversion_error. out->write( 'String has to be truncated. EXACT triggered an exception' ). ENDTRY. var_date = 'ABCDEFGH'. out->write( var_Date ). TRY. var_date = EXACT #( 'ABCDEFGH' ). CATCH cx_sy_conversion_error. out->write( |ABCDEFGH is not a valid date. EXACT triggered an exception| ). ENDTRY. var_date = '20221232'. out->write( var_date ). TRY. var_date = EXACT #( '20221232' ). CATCH cx_sy_conversion_error. out->write( |2022-12-32 is not a valid date. EXACT triggered an exception| ). ENDTRY.
  3. Activez la classe en appuyant sur Ctrl + F3.
  4. Jouez avec le code pour vous familiariser avec le sujet.

Éviter les conversions de types problématiques

Vous examinez de plus près l'édition de la console de votre classe ABAP et vous remarquez que le nom du transporteur est tronqué. Vous remarquez également qu'un problème est survenu avec l'ID de transporteur et l'ID de liaison affichés pour les vols de fret. Vous identifiez les conversions de type problématique comme source de ces problèmes et corrigez votre code en conséquence.

Modèle :

  • /LRN/CL_S4D401_ATS_SQL_TRACE (classe globale)

Solution :

  • /LRN/CL_S4D401_TCS_TYPE_CONV (classe globale)

Tâche 1: Copier modèle (facultatif)

Copiez la classe de modèle /LRN/CL_S4D401_ATS_SQL_TRACE. Si vous avez terminé l'exercice précédent, vous pouvez ignorer cette tâche et continuer à modifier votre classe ZCL_##_SOLUTION.

Étapes

  1. Copiez la classe /LRN/CL_S4D401_ATS_SQL_TRACE dans une classe de votre propre package (nom proposé : ZCL_##_SOLUTION, ## correspondant à votre numéro de groupe).

    1. Dans l'explorateur de projets, cliquez avec le bouton droit de la souris sur la classe /LRN/CL_S4D401_ATS_SQL_TRACE pour ouvrir le menu contextuel.

    2. Dans le menu contextuel, sélectionnez Dupliquer....

    3. Saisissez le nom de votre package dans la zone Package. Dans la zone Nom, saisissez ZCL_##_SOLUTION, où ## représente votre numéro de groupe.

    4. Cliquez sur Next.

    5. Confirmez l'ordre de transport et cliquez sur Terminer.

  2. Activez la copie.

    1. Appuyez sur Ctrl + F3 pour activer la classe.

Tâche 2: Détecter les conversions de types problématiques

Exécutez la classe comme application de console. Contrôlez la sortie de la console, en accordant une attention particulière au nom du transporteur, à l'ID du transporteur et à l'ID de la liaison des vols de fret. Recherchez le code qui produit cette sortie et retracez les données jusqu'à la source, en prêtant attention aux conversions de type potentiellement problématiques. Utilisez l'expression EXACT pour vérifier qu'il existe des conversions de type avec des pertes de données.

Étapes

  1. Exécutez votre classe ABAP ZCL_##_SOLUTION comme application console.

    1. Ouvrez la classe dans l'éditeur et appuyez sur F9.

  2. Contrôlez la sortie de la console.

    1. Faites défiler vers le bas dans la vue Console.

    2. Localisez la ligne commençant par Nom du transporteur :.

    3. Faites défiler vers le bas jusqu'à la ligne commençant par Trouvé un vol cargo approprié et inspectez la ligne suivante.

  3. Revenez au code source de votre classe ABAP et analysez l'implémentation de la méthode if_oo_adt_classrun~main.

  4. Naviguez dans la méthode get_output.

    1. Dans l'appel de méthode carrier->get_output( ), placez le curseur sur le nom de méthode get_output et appuyez sur F3. Vous pouvez également maintenir la touche Ctrl enfoncée et cliquer sur le nom de la méthode.

    2. Dans l'expression me->name, placez le curseur sur le nom et appuyez sur F2 pour afficher les informations d'élément de code pour le nom d'attribut.

    3. Positionnez le curseur sur r_result et appuyez sur F2 pour afficher les informations d'élément de code pour le paramètre de retour r_result de la méthode get_output.

    4. Dans les informations d'élément de code, cliquez sur tt_output pour afficher les informations d'élément de code pour ce type.

    5. Cliquez sur t_output pour accéder aux informations de l'élément de code pour le type de ligne du type de table tt_output.

  5. Modifiez le type de ligne du paramètre r_result. Utilisez un type de ligne alphanumérique de longueur variable.

    1. Dans la barre d'outils en bas des informations de l'élément, sélectionnez Ouvrir dans l'éditeur. Vous pouvez également appuyer sur F3 pour accéder à la définition du type t_output.

    2. Dans la déclaration TYPES t_output TYPE c LENGTH 40., remplacez c LENGTH 40 par string.

  6. Revenez à l'onglet Classe globale et naviguez dans la méthode get_description de la classe lcl_cargo_flight.

    1. Dans l'appel de méthode cargo_flight->get_description( ), placez le curseur sur le nom de méthode get_description et appuyez sur F3. Vous pouvez également maintenir la touche Ctrl enfoncée et cliquer sur le nom de la méthode.

  7. Utilisez le cas d'emploi pour l'attribut carrier_id pour rechercher l'instruction dans laquelle il est renseigné.

    1. Placez le curseur sur carrier_id et sélectionnez Accéder au cas d'emploi dans la barre d'outils Eclipse. Vous pouvez également appuyer sur Ctrl + Maj + G.

    2. Dans la vue Recherche sous l'éditeur, double-cliquez sur la ligne qui commence par carrier_id =.

    3. Dans l'instruction carrier_id = i_carrier_id., positionnez le curseur sur i_carrier_id et appuyez sur F2 pour afficher les informations de l'élément de code pour i_carrier_id.

    4. Dans les informations sur l'élément de code, cliquez sur /dmo/carrier_id pour accéder aux informations de l'élément de code correspondant. Notez que /dmo/carrier_id est de type char(3).

    5. Répétez cette opération en conséquence pour analyser le type technique de carrier_id. Vous trouverez ici le type de données numc(4).

  8. Utilisez l'expression de conversion EXACT pour tester si la conversion de type entraîne une perte d'informations. Activez le code et exécutez-le en tant qu'application de console.

    1. Dans la valorisation, entourez l'objet de données source i_carrier_id de EXACT #( ... ) comme suit :

      ABAP
      1
      carrier_id = EXACT #( i_carrier_id ).
    2. Appuyez sur Ctrl + F3 pour activer la classe.

    3. Appuyez sur F9 pour exécuter la classe en tant qu'application console.

    4. Vous devriez voir une erreur d'exécution CONVT_NO_NUMBER.

  9. Répétez l'analyse de type pour l'affectation connection_id = i_connection_id.

    1. Analysez les types techniques de connection_id et i_connection_id comme à l'étape précédente.

  10. Utilisez l'expression de conversion EXACT pour tester si la conversion de type dans l'affectation connection_id = i_connection_id entraîne une perte d'informations.

    1. Adaptez le code comme suit :

      ABAP
      1
      connection_id = EXACT #( i_connection_id ).
    2. Dans ce cas, le contrôle syntaxique détecte déjà qu'une affectation sans perte n'est pas possible. L'erreur suivante s'affiche : le type "/DMO/CONNECTION_ID" de "I_CONNECTION_ID" n'est pas compatible avec le type "/DMO/CARRIER_ID" de "ME->CONNECTION_ID".

  11. Corrigez les types des attributs carrier_id et connection_id et supprimez les deux expressions EXACT. Activez et testez à nouveau votre code.

    1. Dans l'instruction carrier_id = EXACT #( i_carrier_id )., positionnez le curseur sur carrier_id et appuyez sur F3 pour accéder à la définition de cet attribut. Vous pouvez également maintenir la touche Ctrl enfoncée et cliquer sur le nom de l'attribut.

    2. Dans la déclaration DATA carrier_id TYPE /dmo/connection_id READ-ONLY., remplacez /dmo/connection_id par /dmo/carrier_id.

    3. Dans la déclaration DATA connection_id TYPE /dmo/carrier_id READ-ONLY., remplacez /dmo/carrier_id par /dmo/connection_id.

    4. La déclaration des attributs doit alors ressembler à ceci :

      ABAP
      123456
      * wrong: * DATA carrier_id TYPE /dmo/connection_id READ-ONLY. * DATA connection_id TYPE /dmo/carrier_id READ-ONLY. * correct: DATA carrier_id TYPE /dmo/carrier_id READ-ONLY. DATA connection_id TYPE /dmo/connection_id READ-ONLY.
    5. Corrigez les avertissements de syntaxe Conversion redondante pour le type... en supprimant les expressions EXACT précédemment ajoutées.

    6. Appuyez sur Ctrl + F3 pour activer la classe.

    7. Appuyez sur F9 pour exécuter la classe en tant qu'application console.