Criação de uma Consulta do Task Manager

A criação de uma consulta é a primeira etapa na criação de um relatório personalizado.

Para criar consultas:

  1. Na Homepage, clique em Aplicativo e em Task Manager.

  2. Selecione a guia Relatórios do Task Manager à esquerda.
  3. Na guia Consultas, clique em Nova.
  4. Na tela Nova Consulta, informe um Nome e uma Descrição opcional.

  5. Em Tipo, selecione uma opção:

    • Consulta de Parâmetro: Um tipo Consulta de Parâmetro é usado para apresentar uma lista de opções que você pode especificar para o valor desse parâmetro. Consulta de Parâmetro permite a apresentação de uma lista de opções usadas ao preencher o valor de um parâmetro para uma Consulta de Relatório, onde a lista de opções não é um atributo simples já definido, mas uma consulta complexa que você precisa definir.

      Esse exemplo de consulta de parâmetro fornece uma lista de todos os períodos do Task Manager:

      SELECT PERIOD_ID, PERIOD_NAME FROM FCC_PERIODSWHERE APP_ID=1

    • Consulta de Relatório: Selecione os registros a serem incluídos no relatório. É possível aplicar um filtro de segurança para que os usuários vejam somente os dados a que estão autorizados com base em suas funções e nos relatórios a que estão atribuídos. Para aplicar um Filtro de Segurança a uma consulta de relatório, adicione a seguinte sintaxe ao final da instrução WHERE CLAUSE da consulta.

      $FCC_SECURITY_CLAUSE$

      Ao usar $FCC_SECURITY_CLAUSE$ na consulta, o FCC_TASKS deve estar em um alias de TaskEO

      Como muitas consultas predefinidas incluídas no Task Manager têm o Filtro de Segurança aplicado, você também pode usá-las como exemplos ao criar as suas próprias consultas.

      Por exemplo, a Consulta de Relatório a seguir especifica as tarefas agendadas para exibir o Código da Tarefa, o Nome, o Destinatário e o Agendamento de todas as tarefas de Alta Prioridade na agenda selecionada.

      SELECT TaskEO.TASK_CODEAS "$TASK_CODE$",

      TaskEO.TASK_NAMEAS "$NAME$" ,

      ((SELECT CASE WHEN FIRST_NAME IS NULL AND LAST_NAME IS NULL THEN USER_LOGIN ELSE FIRST_NAME||' '||LAST_NAME END FROM FCM_USERS WHERE USER_ID = (coalesce(AssigneeEO.ACTIVE_USER_ID, AssigneeEO.USER_ID))))AS "$ASSIGNEE$" ,

      DeploymentEO.DEPLOYMENT_NAMEAS "$SCHEDULE$"

      FROM FCC_TASKS TaskEO

      LEFT OUTER JOIN FCC_ACCESS AssigneeEO ON (TaskEO.TASK_ID = AssigneeEO.SOURCE_ID AND AssigneeEO.ACCESS_TYPE = "AS")

      LEFT OUTER JOIN FCC_DEPLOYMENTS DeploymentEO ON (TaskEO.SOURCE_ID = DeploymentEO.DEPLOYMENT_ID)

      WHERE (TaskEO.SOURCE_TYPE = "DEPLOYMENT")

      AND ((((TaskEO.PRIORITY=3 )

      AND (TaskEO.SOURCE_ID=~SCHEDULE~ ))))

  6. Clique em Gerar Consulta para criar a consulta na caixa de diálogo Nova Consulta. A caixa de diálogo auxilia você na criação de uma consulta em relação ao banco de dados, permitindo que você selecione qualquer atributo existente no produto a ser consultado e/ou filtrado. O sistema gera, então, o SQL para corresponder aos atributos e filtros especificados, momento em que é possível modificá-lo e aprimorá-lo.

    1. Na tela Selecionar Tipo, selecione as opções:
      • Em Consulta, selecione Tarefas do Modelo ou Tarefas de Agendamento.
      • Opcional: Marque a caixa de seleção Aplicar Segurança para aplicar automaticamente o filtro de segurança de usuário à consulta gerada. Isso aplica o token de Segurança à consulta, que deverá ser preenchida com o SQL correto quando o relatório for gerado.
    2. Clique em Próximo.
      caixa de diálogo gerar consulta.
  7. Em Selecionar Colunas, selecione as colunas a serem exibidas na consulta e depois clique em Próximo.
    selecionar colunas.
  8. Em Selecionar Filtros, clique em Criar Condição ou em Criar Grupo de Condições e selecione as condições a fim de criar os filtros para criação da consulta.
    selecionar filtros.
  9. Clique em OK.
  10. Opcional: Para usar o relatório no futuro, clique em Gerar XML de Amostra.
  11. Clique em Salvar.
  12. Para testar a consulta em busca de erros:
    • Clique em Validar na caixa de diálogo Nova Consulta. Você também pode selecionar Validar na lista suspensa.

      Validar Consulta

      A consulta é exibida na guia Consultas.

      Nota:

      Você pode facilmente excluir ou duplicar uma consulta usando o menu Ação.

    • Clique em Validar e Explicar Plano na lista suspensa para validar a consulta e também gerar o plano de execução para essa consulta. É gerado um arquivo .txt que usa o mesmo nome que a consulta. É possível exibir ou fazer download do plano gerado.

      Abra esse arquivo para ver o plano gerado, que contém a sequência de etapas que é realizada para executar essa consulta. Se o desempenho de uma consulta for abaixo do ideal, você poderá usar esse plano para entender a causa do problema e determinar a melhor maneira de melhorar o desempenho da consulta.

      Nota:

      Por padrão, a geração de planos de execução está disponível apenas para ambientes OCI (Gen 2). Para habilitá-la para ambientes Clássicos, entre em contato com a Oracle usando uma solicitação de serviço.

Modificação de uma Consulta

Um administrador de sistema pode editar uma consulta do Task Manager .

  1. Na Homepage, clique em Aplicativo e em Task Manager.

  2. Selecione a guia Relatórios do Task Manager à esquerda.

  3. Selecione a guia Consultas se já não estiver selecionada, e depois selecione Editar em ícone de reticências. ao lado da consulta que você está editando.

    Nota:

    Se essa opção estiver bloqueada, peça ao Administrador do Sistema para desbloqueá-la.

  4. Selecione consulta do Task Manager .

  5. Em Editar Consulta, edite as informações conforme necessário.
  6. Quando terminar de fazer suas alterações, clique em Salvar e Fechar.