Modificar a lista de status da solicitação

Este artigo contém os seguintes tópicos:
casm173
Este artigo contém os seguintes tópicos:
Cada serviço e opção de serviço em uma solicitação possuem um status. Além disso, a solicitação possui um status geral. O CA Service Catalog fornece uma lista extensa de valores de status por padrão. Modifique os valores de status para as fases de aprovação e processamento do ciclo de vida da solicitação, ao editar o arquivo requestshared.xml. Também é possível alterar a grafia dos valores de status existentes.
Os valores de status da solicitação são mantidos no arquivo requestshared.xml. Esse arquivo pode ser diferente dependendo do idioma escolhido para o sistema. O arquivo estará localizado em uma pasta diferente para cada idioma. Por exemplo, para inglês (icusen), o arquivo requestshared.xml está localizado na pasta USM_HOME\view\webapps\usm\locale\icusen\request.
O status da solicitação da solicitação
inteira
é visível na página Ações pendentes. Os status de solicitação de itens individuais na solicitação estão visíveis na lista suspensa Status do item nas páginas de interface do usuário relacionadas à solicitação: Detalhes da solicitação, Aprovar solicitação, Processar solicitação e Enviar solicitação. As atualizações que você faz nos valores de status das solicitações no arquivo requestshared.xml se refletem nas opções que os usuários visualizam nessas páginas.
Siga estas etapas:
  1. Faça backup do arquivo requestshared.xml original e salve-o para referência.
  2. (Opcional) Modifique valores de status existentes ou adicione outros status de solicitação.
  3. (Opcional) Restrinja as alterações de status disponíveis para um item de solicitação com base em seu status.
    Por padrão, todas as opções (todos os status) estão sempre disponíveis para um item, até que toda a solicitação seja concluída. Em outras palavras, é possível mudar o status dos itens de solicitação para qualquer valor a qualquer momento. Contudo, como opção, sua empresa pode restringir as opções de menu disponíveis para um item de solicitação com base em seu status.
  4. Teste suas mudanças verificando se elas se refletem corretamente nas telas da interface do usuário relacionadas às solicitações.
    Na lista suspensa Status do item nas páginas da interface do usuário relacionadas à solicitação, o status é indicado por um asterisco (*).
Após acrescentar valores numéricos de status à lista padrão e usá-los,
não os remova
.
Verificar requestshared.xml
Familiarize-se com o arquivo requestshared.xml, da seguinte maneira:
  • Entender o objetivo das seções principais do arquivo: request_header, request_item, request_item_approval_action e request_item_fulfillment_action.
  • Entender que os valores de status nessas seções devem permanecer sincronizados.
  • Compreenda que a ordem dos status nas listas de menu suspenso de status na GUI corresponde à ordem dos status no arquivo requestshared.xml. Por exemplo, suponha que o status 800 (Rejeitar) foi definido acima do status 600 (Aprovado) neste arquivo. Nesse caso, o status Rejeitar será exibido acima do status Aprovado nas listas suspensas de status na GUI.
  • Revise os comentários inline e anote os valores de status
    reservados
    .
  • Revise os intervalos de valores de status personalizados para ver quais intervalos são reservados para tipos específicos de valores de status.
Não
modifique nem exclua as linhas iniciais e finais que definem os status padrão no arquivo requestshared.xml. Mesmo quando modificar os status, essas linhas devem permanecer conforme mostrado. Esse requisito se aplica a ambas as seções request_item_approval> e . Essas linhas ajudam a assegurar o comportamento adequado do status quando as personalizações não são usadas ou são definidas incorretamente.
- <custom_menu current_status_value="default"> status lines </custom_menu>
Seções principais
As principais seções do arquivo requestshared.xml são como segue:
  • request_header
    Mantém todos os valores de status possíveis para toda a solicitação.
  • request_item
    Mantém todos os valores de status possíveis para um item específico (como um elemento de opção de serviço ou grupo de opções de serviço) em uma solicitação.
  • request_item_approval_action
    Mantém todos os valores de status possíveis para um item específico em uma solicitação, quando a solicitação tiver sido enviada, mas não foi aprovada ou rejeitada.
  • request_item_fulfillment_action
    Mantém todos os valores de status possíveis para um item específico em uma solicitação, quando a solicitação tiver sido aprovada, mas ainda não foi processada.
A lista de valores possíveis de status deve ser sincronizada nas seções request_header e request_item, o que significa que devem possuir os mesmos valores com o mesmo significado.
Todos os valores nas seções request_item_approval_action e request_item_fulfillment_action devem possuir um valor correspondente tanto na seção request_header como na request_item. O valor das seções request_item_approval_action e request_item_fulfillment_action deve ser um conjunto ou subconjunto completo dos valores nas seções request_header e request_item.
Intervalos de valores de status personalizados
Ao acrescentar um novo status de solicitação no arquivo requestshared.xml, defina-o dentro do intervalo especificado para os status personalizados:
  • 300 a 399 - status de
    envio
    personalizado
  • 500 a 599 - status de
    aprovação pendente
    personalizado
  • 900 a 990 - status
    aprovado
    personalizado
Adicionar outro status de solicitação
É possível modificar a lista de status de solicitação, adicionando status de solicitação. Uma finalidade comum é aprovação ou rejeição de uma solicitação por um departamento específico. Por exemplo, o departamento financeiro.
Siga estas etapas:
  1. Edite o arquivo requestshared.xml para o idioma do seu sistema em um editor de texto. Por exemplo, para inglês, edite o arquivo na pasta USM_HOME\exibição\aplicativosdaweb\usm\idioma\icusen\solicitação.
  2. Adicione outra linha, incluindo o número e o texto para o novo status nas seguintes seções: <request_header> e <request_item>.
  3. Selecione um valor de status numérico não utilizado no intervalo apropriado de valores de status personalizados para o status que você está adicionando.
    Se possível, limite o texto do valor de status a 40 caracteres. Um texto com mais de 40 caracteres pode ser truncado nas listas suspensas do menu de status e campos de status de solicitação. Nesses casos, a sequência de caracteres de texto completa é exibida para os usuários de catálogo
    apenas
    no texto de dica.
  4. Copie essa linha para a(s) seção(ões) personalizada(s) em que deseja que ela apareça. Os exemplos incluem <request_item_approval>, <request_item_fulfillment>,
    e .
  5. Exclua o texto da linha que copiou e modifique a linha para incluir a expressão statval="
    value
    ".
  6. Salve o arquivo requestshared.xml.
  7. Verifique se as mudanças se refletem corretamente nas telas da interface de usuário relacionada à solicitação (as telas Detalhes da solicitação, Aprovar solicitação e Processar solicitação).
Exemplo: Adicionar novos status de aprovação
Para acrescentar os status de aprovação 500, 700 e 900, todos relacionados à aprovação financeira, adicione as novas linhas para esses status nas seções request_header, request_item e request_item_approval_action do arquivo requestshared.xml. Exemplos a seguir, em
negrito
.
Especifique o valor numérico e texto nas seções request_header e request_item. Especifique apenas o valor numérico (sem o texto) na seção 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"/> ...
Ocultar status de solicitação
A lista padrão de status de solicitação pode ter mais opções do que você precisa para certas categorias. É possível ocultar alguns valores da categoria. Portanto, os usuários não veem essas opções na GUI quando eles manipulam solicitações com ação pendente.
Siga estas etapas:
  1. Edite o arquivo requestshared.xml para o idioma do seu sistema, usando um editor de texto. Por exemplo, para inglês, edite o arquivo na pasta USM_HOME\exibição\aplicativosdaweb\usm\idioma\icusen\solicitação.
  2. Edite a linha nas seções <request_header> e <request_item> para cada status que você deseja editar. Digite os caracteres de comentário antes e depois da expressão original.
  3. Oculte as linhas correspondentes em todas as outras seções que a usam, como <request_item_approval> ou <request_item_fulfillment>.
    Oculte exatamente as mesmas linhas em todas as seções relevantes do arquivo. Isso é necessário para que o status apareça corretamente na interface do usuário.
  4. Salve o arquivo requestshared.xml.
  5. Teste suas alterações verificando se elas refletem corretamente nas seguintes páginas relacionadas à solicitação: Detalhes da solicitação, Aprovar solicitação e Processar solicitação.
Exemplo: Ocultar status de solicitação
Para ocultar certos status padrão relacionados a processamento, digite os caracteres de comentário antes e depois da expressão origina. Exemplo em
negrito
. Digite os caracteres de comentário nas seções request_header, request_item e request_item_fulfillment_action do arquivo requestshared.xml.
Nesse exemplo,
antes
de adicionar os marcadores de comentários, os seguintes status são visíveis nas páginas relacionadas à solicitação: Solicitado, Enviado, Recebido, Pedido cancelado, Armazenado temporariamente e Configurado.
Após
os marcadores de comentários serem acrescentados, os seguintes status estão visíveis nessas páginas: Solicitado, Enviado e Configurado.
- <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>
Restringir as alterações de status disponíveis para um item de solicitação
Você pode restringir as alterações de status disponíveis para um item de solicitação com base no seu status atual. Por exemplo, suponha que, após um item ser aprovado (status Aprovado), os usuários não possam mais mudar o status,
exceto
para um status relacionado ao processamento. É possível configurar a lista suspensa Status do item para mostrar
apenas
opções relacionadas ao processamento para os itens cujo status atual é aprovado.
Siga estas etapas:
  1. Edite o arquivo requestshared.xml para o idioma do seu sistema, usando um editor de texto. Por exemplo, no caso do inglês, edite o arquivo na pasta USM_HOME\exibição\aplicativosdaweb\usm\idioma\icusen\solicitação\solicitaçõescompartilhadas.xml.
  2. Localize a seção do arquivo na qual deseja restringir as alterações disponíveis para um ou mais valores de status.
    É possível restringir as alterações de status em qualquer seção,
    exceto
    nas seções e .
  3. Decida qual status você deseja restringir e os status em que serão permitidas alterações.
    A relação com todos os valores de status existentes é exibida sob a linha a seguir:
    - <custom_menu current_status_value="default">
  4. Adicione um status de solicitação para permitir em sua lista, se necessário. Os status que você deseja permitir já devem existir.
  5. Localize a seção de menu personalizada. Por padrão, essa seção é recuada e comentada. Exclua as linhas iniciais e finais de comentário desta seção.
    - <!-- <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. Na primeira linha desta seção, certifique-se de que o valor da expressão current_status_value="
    nnn
    " combina com o valor de status que você deseja restringir.
    Por exemplo, na etapa anterior, 400 corresponde ao status Aprovação pendente. Logo, os valores de status mostrados serão exibidos em páginas relacionadas à solicitação quando o valor do status for Aprovação pendente. Se quiser restringir outro status, substitua o valor atual pelo novo valor.
  7. Certifique-se de que o valor da expressão current_status_value="
    nnn
    " esteja definido em uma das linhas "<st_
    nnn
    statval=...", conforme mostrado para Aprovação pendente no exemplo anterior.
  8. Copie e cole o status ou os status adicionais ao qual você deseja permitir a alteração de status. Você pode copiar e colá-lo(s) na lista de valores de status no início desta seção.
    Por exemplo, na seção <request_item_approval>, copie e cole a nova linha <st_801..." para a seção custom_menu para Aprovação pendente:
  9. O status Aprovação desnecessária é adicionado aos status para os quais os itens no status Aprovação pendente podem ser altrados.
  10. Restrinja as alterações de status para outro status na mesma seção do arquivo requestshared.xml se necessário. Use estas diretrizes:
    1. Copie todo o elemento custom_menu e seus filhos.
    2. Cole-o após o elemento atualizado.
    3. Modifique o elemento recém-copiado.
    4. Modifique um elemento custom_menu existente e seus filhos se necessário. Por exemplo, na seção <request_item_fulfillment>, suponha que você deseja restringir itens no status Processamento pendente para serem alterados para o Processamento cancelado ou Processado. Nesse caso, modifique o elemento custom_menu existente da seguinte maneira:
    <custom_menu current_status_value="1000"> <st_1000 statval="1000"/> <st_1999 statval="1999"/> <st_2000 statval="2000"/> </custom_menu>
  11. Salve o arquivo requestshared.xml.
  12. Verifique se as mudanças se refletem corretamente nas páginas da interface de usuário relacionada à solicitação (as páginas Detalhes da solicitação, Aprovar solicitação e Processar solicitação).
Você restringiu as alterações de status disponíveis para um item de solicitação com base no status atual.