Extraindo dados usando filtros nativos

É possível usar filtros nativos com todas as origens de dados suportadas. .

Antes de Iniciar

Se você estiver integrando o Rational Publishing Engine com um produto que não suporta origens de dados REST relatáveis, o conjunto de dados inteiro será buscado e não poderá ser filtrado. Para verificar se seu produto suporta origens de dados REST relatáveis, você pode testar a condição do filtro na origem de dados nativos antes de usá-lo no Rational Publishing Engine.

Revise o documento de Reportable Rest v1 para obter mais informações sobre como definir requisitos de serviços REST v1 relatáveis.

Sobre Esta Tarefa

Os filtros nativos são suportados pelas origens de dados REST relatáveis, que permitem a filtragem, classificação e suporte seletivo de propriedades. O filtro nativo solicita um conjunto de dados da origem de dados e, em seguida, filtra e refina os dados para saída de um modelo Rational Publishing Engine. Não é necessário criar filtros no produto do qual os dados são provenientes, a menos que você quiera testar os filtros para precisão, mas pode criar filtros exclusivamente para uso nos modelos Rational Publishing Engine de dentro de Rational Publishing Engine.

Em liberações anteriores do Rational Publishing Engine, você só poderia definir filtros que eram estáticos. Você tinha que saber onde os filtros estavam quando projetou o modelo e eles não podiam ser alterados no tempo de execução.

Procedimento

  1. No Document Studio, selecione o elemento de modelo que contém a consulta que deve ser filtrada.
  2. Na visualização Propriedades, selecione a guia Dados.
  3. No campo Filtro, clique no botão de reticências.
  4. Na guia Filtro nativo, expanda Variáveis.
    Nota: Variáveis usadas em filtros podem ser modificadas antes que a primeira consulta na origem de dados seja usada.
  5. Selecione uma variável na qual filtrar.
  6. Insira a sintaxe ${} para definir que sua consulta seja filtrada. Por exemplo, é possível filtrar por um nome de produto. Várias equipes de produtos podem usar esse modelo e especificar um nome de produto na especificação do documento no tempo de execução.
    cq:Product{cq:Product"${productName}"
    Nota:
    • Os atributos customizados não podem ser usados em filtros nativos.
    • Se você renomear uma variável, o nome não será atualizado em uma expressão de script ou filtro nativo e criará um erro de referência. Quando você renomear uma variável, assegure-se de revisar o nome nas expressões de script e filtros nativos também.
    • Para extrair dados do Rational DOORS, use o script DXL como condição do filtro nativo. Para extrair dados REST, use a condição do filtro XPath.
  7. Clique em OK.

Origens de dados que suportam a sintaxe Rest v1 relatável

Nos filtros nativos Rest v1 relatáveis, só é necessário digitar o texto entre os colchetes []. O resto do filtro é gerado pelo Rational Publishing Engine.

Design Management

Design Management suporta a filtragem nativa das origens de dados Rest v1 relatáveis. Para obter mais informações, consulte Reportable Rest v1.

IBM Rational ClearCase

O adaptador Rational ClearCase suporta filtragem nativa das origens de dados Rest v1 relatáveis. Consulte Reportable Rest v1 para obter informações adicionais.

IBM Rational ClearQuest

O adaptador Rational ClearQuest suporta filtragem nativa de origens de dados Rest v1 relatáveis. Consulte Reportable Rest v1 para obter informações adicionais.

IBM Rational DOORS Next Generation

Rational DOORS Next Generation suporta a filtragem nativa de origens de dados Rest v1 relatáveis. Consulte Rational Requirements Composer origens de dados para obter mais informações. Essas informações se aplicam a fontes de dados do Rational DOORS Next Generation e do Rational Requirements Composer.

IBM Rational Quality Manager

Rational Quality Manager suporta a filtragem nativa de origens de dados Rest v1 relatáveis. Consulte Rational Quality Manager API REST relatável para obter mais informações.

IBM Rational RequisitePro

O exemplo de filtro nativo Rest v1 relatável extrai o esquema PRRequirements de Rational RequisitePro usando Stability='High'.

Exemplo

Inclua uma expressão de filtro para o nó em Dispositivos, para que apenas os dispositivos fabricados por um fabricante específico sejam selecionados.
fields=Project/Requirements/PRRequirement[Stability = 'High']/(Stability|FullTag|Priority|Status)

IBM Rational Rhapsody

Rational Rhapsody suporta origens de dados Rest v1 relatáveis para uso em filtros nativos. Para obter mais informações, consulte Reportable Rest v1.

IBM Rational Team Concert

Rational Team Concert suporta origens de dados Rest v1 relatáveis para uso em filtros nativos. Consulte Reportable REST API on Jazz.net para obter informações adicionais.

Exemplo

[projectArea/name="JKESample"]/*
Resolved request:
https://server:port/ccm/rpt/repository/workitem?fields=workitem/workItem[projectArea/name="JKESample"]/(@href|summary)

Aplicativo Requirements Management

O aplicativo Requirements Management suporta a filtragem nativa de origens de dados Rest v1 relatáveis. Os recursos que são fornecidos pelo aplicativo Requirements Management (RM) são licenciados como IBM® Rational DOORS Next Generation. As informações sobre a integração de aplicativos RM se aplica ao Rational DOORS Next Generation e a versões específicas de IBM Rational Requirements Composer. Consulte Origens de dados de Rational Requirements Composer para obter mais informações.

Origens de dados que suportam a sintaxe Rest v2 relatável

Sobre Esta Tarefa

Nota:
  • Solicitações são feitas para uma origem de dados apenas quando necessário. Por exemplo, é possível usar condições para ter a exibição de um elemento na saída somente quando ele contém dados. A condição em um elemento de contêiner pode ser variable == "true". Se esta condição não for atendida e nenhum dado atender à condição da variável, nenhuma solicitação será feita na origem de dados.
  • É possível calcular filtros nativos antes de fazer a solicitação. O filtro nativo é calculado no ponto em que a consulta é encontrada e usa os valores de variável nesse ponto. Então você pode executar cálculos no modelo, o que afetará os filtros nativos.

IBM Rational ClearQuest

Rational ClearQuest versão 8 suporta a filtragem nativa de origens de dados Rest v2 relatáveis. Para obter mais informações, consulte API REST de Rational ClearQuest OSLC CM.

Exemplo

Filtro de variável de amostra:
cq:Product{cq:Product="${productName}") 
Filtro resolvido de amostra no qual productName é Rational Publishing Engine:
cq:Product{cq:Product="Rational Publishing Engine")

Origens de dados que suportam a sintaxe de API proprietária

IBM Rational DOORS

Rational DOORS suporta uma API proprietária e o filtro é expresso utilizando a sintaxe de visualização de Rational DOORS.

Exemplo

O seguinte exemplo de filtro nativo do Rational DOORS filtra objetos que contêm a palavra "Documentation" no atributo de texto do objeto.
Attribute 'Object Text' contains 'Documentation' (case sensitive)
Para gerar o texto de filtro nativo para uma origem de dados do Rational DOORS:
  1. Abra um módulo do Rational DOORS e, em seguida, clique em Ferramentas > Filtrar > Definir entrada de menu.
  2. Crie a sintaxe de filtro:
    1. Selecione a guia Attributes.
    2. Para Atributo, selecione Object Text.
    3. Para Condição, selecione Contains.
    4. Para Valor, insira um valor específico no qual filtrar. Por exemplo, para filtrar apenas os objetos que contêm a palavra Documentation no atributo Objetct Text, insira: Documentation
    5. Clique em Incluir. Na seção Opções avançadas, a sintaxe de regra é criada.
  3. Clique em Descrição e copie a descrição completa. Agora você tem o filtro do Rational DOORS, que é um script DXL.
Para incluir o filtro de Rational DOORS no elemento de modelo do Rational Publishing Engine:
  1. Selecione o elemento de modelo que contém a consulta que deve estar filtrada.
  2. Na guia Propriedades, expanda Dados.
  3. No campo Filtro, clique no botão de reticências. A janela Editor de filtro é aberta.
  4. Na guia Filtro nativo, cole o filtro do Rational DOORS (script DXL) e clique em OK.