Modification de la liste des statuts de demande

Cet article contient les rubriques suivantes :
casm173
Cet article contient les rubriques suivantes :
Chaque service et option de service dans une demande a un statut. La demande a également un statut global. CA Service Catalog fournit une liste complète de valeurs de statut par défaut. Vous pouvez modifier les valeurs de statut pour les phases d'approbation et d'exécution du cycle de vie des demandes. Pour cela, modifiez le fichier requestshared.xml. Vous pouvez également modifier les valeurs de statut existantes.
Les valeurs de statut des demandes sont conservées dans le fichier requestshared.xml. Ce fichier peut varier en fonction de la langue choisie pour le système. Le fichier se trouve dans un dossier différent pour chaque langue. Par exemple, pour l'anglais (icusen), le fichier requestshared.xml se trouve dans le dossier USM_HOME\view\webapps\usm\locale\icusen\request.
Le statut de l'
intégralité
de la demande est affiché dans la page d'actions en attente. Les statuts de demande des éléments de la demande sont affichés dans la liste déroulante Statut de l'élément dans les pages d'interface utilisateur associées à la demande : Détails de la demande, Approuver la demande, Exécuter la demande et Forcer l'exécution de la demande. Les mises à jour apportées aux valeurs de statut de demande dans le fichier requestshared.xml sont appliquées dans les options affichées dans ces pages.
Procédez comme suit :
  1. Sauvegardez le fichier requestshared.xml d'origine et enregistrez-le pour référence.
  2. (Facultatif) Modifiez les valeurs de statut existantes ou ajoutez des statuts de demande supplémentaires.
  3. (Facultatif) Limitez les changements de statut disponibles pour un élément de demande en fonction de son statut.
    Par défaut, toutes les options (statuts) sont toujours disponibles pour un élément, jusqu'à ce que l'intégralité de la demande soit terminée. En d'autres termes, vous pouvez modifier le statut des éléments de demande sur une valeur à tout moment. Toutefois, votre organisation peut également restreindre les options de menu disponibles pour un élément de demande en fonction de son statut.
  4. Testez les modifications apportées et vérifiez qu'elles s'affichent correctement dans les fenêtres de l'interface utilisateur associées à la demande.
    Dans la liste déroulante Statut de l'élément des pages de l'interface utilisateur associées à la demande, le statut est désigné par un astérisque (*).
Après avoir ajouté et utilisé des valeurs numériques de statut dans la liste par défaut, ne les supprimez
pas
.
Vérification du fichier requestshared.xml
Familiarisez-vous avec le fichier requestshared.xml, comme suit :
  • Tenez compte de l'objectif des principales sections du fichier : request_header, request_item, request_item_approval_action et request_item_fulfillment_action.
  • Les valeurs de statut de ces sections doivent être synchronisées.
  • L'ordre des statuts dans les listes déroulantes de statut de l'interface utilisateur correspond à l'ordre des statuts du fichier requestshared.xml. Par exemple, le statut 800 (Rejeté) est défini au-dessus du statut 600 (Approuvé) dans ce fichier. Dans ce cas, le statut Rejeté s'affiche au-dessus du statut Approuvé dans les listes déroulantes de statut de l'interface utilisateur.
  • Examinez les commentaires en ligne et notez les valeurs de statut
    réservé
    .
  • Vérifiez les plages de valeurs de statut personnalisées pour afficher les plages réservés pour certains types de valeurs de statut.
Vous ne d
eve
z pas modifier ni supprimer les lignes d'ouverture et de fermeture qui définissent les statuts par défaut dans le fichier requestshared.xml. Même lorsque vous modifiez des statuts, ces lignes doivent rester intactes. Cette exigence s'applique aux sections et . Ces lignes permettent de garantir le comportement du statut approprié lorsque les personnalisations ne sont pas utilisées ou mal définies.
- <custom_menu current_status_value="default"> status lines </custom_menu>
Sections principales
Les sections principales du fichier requestshared.xml sont les suivantes :
  • request_header
    Gère toutes les valeurs de statut possibles pour l'intégralité de a demande.
  • request_item
    Gère toutes les valeurs de statut possibles pour un élément (élément d'option de service, groupe d'options de service, etc.) dans une demande.
  • request_item_approval_action
    Gère toutes les valeurs de statut possibles pour un élément dans une demande, lorsque la demande a été soumise, mais ni approuvée, ni rejetée.
  • request_item_fulfillment_action
    Gère toutes les valeurs de statut possibles pour un élément dans une demande, lorsque la demande a été approuvée, mais n'a pas encore été remplie.
La liste des valeurs de statut possibles doit être synchronisée dans les sections request_header et request_item : elles doivent avoir les mêmes valeurs avec la même signification.
Chaque valeur dans les sections request_item_approval_action et request_item_fulfillment_action doit comporter une valeur correspondante dans les sections request_header et request_item. La valeur dans les sections request_item_approval_action et request_item_fulfillment_action doit être un ensemble ou un sous-ensemble complet de valeurs des sections request_header et request_item.
Plages de valeurs de statut personnalisées
Lorsque vous ajoutez un nouveau statut de demande dans le fichier requestshared.xml, définissez-le dans la plage spécifiée pour les statuts personnalisés :
  • 300 à 399 : statut
    Soumettre
    personnalisé
  • 500 à 599 : statut
    En attente d'approbation
    personnalisé
  • 900 à 990 : statut
    Approuvé
    personnalisé
Ajout d'un statut de demande supplémentaire
Vous pouvez modifier la liste des statuts de demande en ajoutant des statuts. Un statut supplémentaire peut être ajouté dans le but de permettre à un département spécifique d'approuver ou de rejeter une demande. Par exemple, le département des finances.
Procédez comme suit :
  1. Dans un éditeur de texte, modifiez le fichier requestshared.xml pour prendre en charge la langue de votre système. Par exemple, pour l'anglais (icusen), le fichier requestshared.xml se trouve dans le dossier USM_HOME\view\webapps\usm\locale\icusen\request.
  2. Ajoutez une ligne, y compris le numéro et le texte du nouveau statut, dans les sections suivantes : et .
  3. Sélectionnez une valeur de statut numérique non utilisée dans la plage appropriée pour les valeurs de statut personnalisées pour le statut ajouté.
    Si possible, limitez le texte de la valeur de statut à 40 caractères. Les textes dépassant 40 caractères peuvent être tronqués dans les listes déroulantes de statut et dans les champs de statut de demande. Dans ce cas, l'intégralité de la chaîne de texte s'affiche
    uniquement
    dans le texte de l'info-bulle pour les utilisateurs du catalogue.
  4. Copiez cette ligne dans la ou les sections personnalisées dans lesquelles vous voulez les afficher. Les exemples incluent les sections , ,
    et .
  5. Supprimez le texte de la ligne que vous avez copié et modifiez la ligne pour inclure l'expression statval="
    valeur
    ".
  6. Enregistrez le fichier requestshared.xml.
  7. Vérifiez que les modifications sont appliquées correctement dans les fenêtres de l'interface utilisateur associées à la demande (Détails de la demande, Approuver la demande et Exécuter la requête).
Exemple : ajout de nouveaux statuts d'approbation
Pour ajouter les statuts d'approbation 500, 700 et 900 relatifs à l'approbation financière, ajoutez les lignes pour ces statuts aux sections request_header, request_item et request_item_approval_action du fichier requestshared.xml. Reportez-vous aux exemples
en gras
suivants.
Spécifiez la valeur numérique et le texte dans les sections request_header et request_item. Spécifiez la valeur numérique (sans texte) dans la section request_item_approval_action.
<?xml version="1.0" encoding="UTF-8" ?> ... - <request_header> <!-- status values must be synchronized with the status list in request_item, request_item_approval_action and/or request_item_fulfillment_action --> <st_1>Pending</st_1> <st_2>Completed</st_2> ... <!-- 400 to 499 are reserved --> <st_400>Pending Approval</st_400> <!-- 500 to 599 can be used for custom pending approval status --> <st_500>Pending Financial Approval</st_500> <!-- 600 to 699 are reserved --> <st_600>Rejected</st_600> <!-- 700 to 799 can be used for custom rejected status --> <st_700>Rejected by Financial Approver</st_700> <!-- 800 to 899 are reserved --> <st_800>Approved</st_800> <st_801>Approval Not Needed</st_801> <!-- 900 to 990 can be used for custom approved status --> <st_900>Approved by Financial Approver</st_900> !-- 991 to 999 are reserved --> <st_999>Approval Done</st_999> ... </request_header> - <request_item> <!-- status values must be synchronized with the status list in request_header, request_item_approval_action and/or request_item_fulfillment_action --> <st_1>Pending</st_1> <st_2>Completed</st_2> ... <!-- 400 to 499 are reserved --> <st_400>Pending Approval</st_400> <!-- 500 to 599 can be used for custom pending approval status --> <st_500>Pending Financial Approval</st_500> <!-- 600 to 699 are reserved --> <st_600>Rejected</st_600> <!-- 700 to 799 can be used for custom rejected status --> <st_700>Rejected by Financial Approver</st_700> <!-- 800 to 899 are reserved --> <st_800>Approved</st_800> <st_801>Approval Not Needed</st_801> <!-- 900 to 990 can be used for custom approved status --> <st_900>Approved by Financial Approver</st_900> <!-- 991 to 999 are reserved --> <st_999>Approval Done</st_999> ... </request_item> - <request_item_approval_action> <!-- status values must be synchronized with the status list in request_header and request_item --> <!-- A "default" value for the attribute "current_status_value" indicates these statuses will be listed by default in the "item status" menu if no other custom statuses are defined --> <custom_menu current_status_value="default"> <!-- 400 to 499 are reserved --> <!-- 500 to 599 can be used for custom pending approval status --> <st_500 statval="500"/> <!-- 600 to 699 are reserved --> <!-- 700 to 799 can be used for custom rejected status --> <st_700 statval="700"/> <!-- 800 to 899 are reserved --> <st_800 statval="800">Approve</st_800> <!-- 900 to 999 can be used for custom approved status --> <st_900 statval="900"/> ...
Masquage des statuts de demande
La liste des statuts de demande par défaut peut inclure des options dont vous n'avez pas besoin pour certaines catégories. Vous pouvez masquer certaines valeurs de cette catégorie. Ces options ne s'affichent donc plus dans l'interface utilisateur lorsque les utilisateurs gèrent les demandes en attente d'action.
Procédez comme suit :
  1. Dans un éditeur de texte, modifiez le fichier requestshared.xml pour prendre en charge la langue de votre système. Par exemple, pour l'anglais (icusen), le fichier requestshared.xml se trouve dans le dossier USM_HOME\view\webapps\usm\locale\icusen\request.
  2. Modifiez la ligne dans les sections <request_header> et <request_item> pour chaque statut à masquer. Entrez les caractères de commentaire avant et après l'expression d'origine.
  3. Masquez les lignes correspondantes dans toutes les autres sections qui l'utilisent, par exemple <request_item_approval> ou <request_item_fulfillment>.
    Masquez les mêmes lignes dans toutes les sections correspondantes du fichier. Cela permet d'afficher le statut correctement dans l'interface utilisateur.
  4. Enregistrez le fichier requestshared.xml.
  5. Testez les modifications apportées et vérifiez qu'elles s'affichent correctement dans les pages relatives aux demandes suivantes : Détails de la demande, Approuver la demande et Exécuter la demande.
Exemple : masquage des statuts de demande
Pour masquer certains statuts liées à l'exécution des demandes par défaut, entrez les caractères de commentaire avant et après l'expression d'origine. Consultez l'exemple
en gras
suivant. Entrez les caractères de commentaire dans les sections request_header, request_item et request_item_fulfillment_action du fichier requestshared.xml.
Dans cet exemple,
avant
d'ajouter les marques de commentaire, les statuts suivants s'affichent dans les pages relatives à la demande : Commandé, Expédié, Reçu, Commande annulée, Placé en zone de stockage intermédiaire et Configuré.
Après
avoir ajouté les marques de commentaire, les statuts suivants s'affichent dans les pages : Commandé, Expédié et Configuré.
- <request_header> ... <st_1004>Ordered</st_1004> <st_1006>Shipped</st_1006> <!--<st_1007>Received</st_1007>--> <!--<st_1008>Order Cancelled</st_1008>--> <!--<st_1017>Staged</st_1017>--> <st_1019>Configured</st_1019> ... </request_header> - <request_item> ... <st_1004>Ordered</st_1004> <st_1006>Shipped</st_1006> <!--<st_1007>Received</st_1007>--> <!--<st_1008>Order Cancelled</st_1008>--> <!--<st_1017>Staged</st_1017>--> <st_1019>Configured</st_1019> ... </request_item> - <request_item_fulfillment_action> ... <custom_menu current_status_value="default"> ... <st_1004 statval="1004"/> <st_1006 statval="1006"/> <!--<st_1007 statval="1007"/>--> <!--<st_1008 statval="1008"/>--> <!--<st_1017 statval="1017"/>--> <st_1019 statval="1019"/> ... </shared>
Limitation des changements de statut disponibles pour un élément de demande
Vous pouvez limiter les changements de statut disponibles pour un élément de demande selon son statut actuel. Par exemple, lorsqu'un élément est Approuvé, vous voulez que les utilisateurs ne soient plus en mesure de modifier le statut,
excepté
sur un statut d'exécution. Vous pouvez configurer la liste déroulante Statut de l'élément pour afficher
uniquement
les options d'exécution des éléments dont le statut est Approuvé.
Procédez comme suit :
  1. Dans un éditeur de texte, modifiez le fichier requestshared.xml pour prendre en charge la langue de votre système. Par exemple, pour l'anglais, modifiez le fichier qui se trouve dans le dossier USM_HOME\view\webapps\usm\locale\icusen\request\requestshared.xml.
  2. Recherchez la section du fichier dans lequel vous souhaitez limiter les modifications disponibles pour une ou plusieurs valeurs de statut.
    Vous pouvez restreindre les changements de statut dans toutes les sections,
    à l'exception
    des sections et .
  3. Décidez quel statut limiter et les statuts pour lesquels les modifications sont autorisées.
    La liste de toutes les valeurs de statut existantes s'affiche sous la ligne suivante :
    - <custom_menu current_status_value="default">
  4. Ajoutez un statut de demande à autoriser dans la liste, si nécessaire. Les statuts que vous souhaitez autoriser doivent déjà exister.
  5. Recherchez la section de menu personnalisé. Par défaut, cette section est mise en retrait et mise en commentaire. Supprimez les lignes de commentaire d'ouverture et de fermeture de la section.
    - <!-- <custom_menu current_status_value="400"> <st_400 statval="400"/> <st_600 statval="600"/> </custom_menu> --> <custom_menu current_status_value="400"> <st_400 statval="400">/> <st_600 statval="600"/> </custom_menu> <custom_menu current_status_value="400"> <st_400 statval="400"/> <st_600 statval="600"/> <st_801 statval="801"/> </custom_menu>
  6. Vérifiez que la valeur dans l'expression current_status_value="
    nnn
    " de la première ligne de la section correspond à la valeur de statut que vous souhaitez limiter.
    Par exemple, dans l'étape précédente, 400 correspond au statut En attente d'approbation. Par conséquent, les valeurs de statut indiquées s'affichent dans les pages de demande lorsque la valeur de statut est En attente d'approbation. Si vous souhaitez limiter un statut différent, remplacez la valeur actuelle par la nouvelle valeur.
  7. Vérifiez que la valeur dans l'expression current_status_value="
    nnn
    " est définie dans l'une des lignes "<st_
    nnn
    statval =...", comme dans l'exemple précédent pour le statut En attente d'approbation.
  8. Copiez et collez le ou les statuts supplémentaires pour lesquels vous souhaitez autoriser les modifications. Vous pouvez les copier et coller à partir de la liste des valeurs de statut mentionnées précédemment dans la section.
    Par exemple, dans la section <demande_approbation_élément>, copiez et collez la nouvelle ligne <st_801... dans la section custom_menu pour le statut En attente d'approbation :
  9. Le statut Approbation facultative est ajouté aux statuts pour lesquels les éléments dont le statut est En attente d'approbation peuvent être modifiés.
  10. Limitez les changements de statut d'un autre statut dans la même section du fichier requestshared.xml, si nécessaire. Suivez ces étapes :
    1. Copiez l'élément custom_menu entier et ses enfants.
    2. Collez-le après l'élément mis à jour.
    3. Modifiez l'élément copié.
    4. Modifiez l'élément custom_menu existant et ses enfants, si nécessaire. Par exemple, dans la section <request_item_fulfillment>, vous souhaitez limiter la modification des éléments dont le statut est En attente d'exécution sur le statut Exécution annulée ou Exécution terminée. Dans ce cas, modifiez l'élément custom_menu existant comme suit :
    <custom_menu current_status_value="1000"> <st_1000 statval="1000"/> <st_1999 statval="1999"/> <st_2000 statval="2000"/> </custom_menu>
  11. Enregistrez le fichier requestshared.xml.
  12. Vérifiez que les modifications sont appliquées correctement dans les pages de l'interface utilisateur associées à la demande (Détails de la demande, Approuver la demande et Exécuter la requête).
Vous avez limité les changements de statut disponibles pour un élément de demande selon son statut actuel.