Incluindo um elemento de configuração de origem de dados

Você pode incluir elementos de origem de dados dinâmicos para que sejam definidos no tempo de execução. O elemento de configuração da origem de dados permite reconfigurar a origem de dados.

Rational Publishing Engine calcula as URLs de origens de dados estáticos quando a geração de documentos inicia e não quando a primeira consulta da origem de dados é acessada. Com elementos de configuração de origem de dados, é possível controlar o tempo de avaliação de elementos durante a geração de documentos.

Elementos da configuração de origem de dados são úteis quando você não conhece as informações de conexão ao começar a criar seu documento. Por exemplo, se você vinculou artefatos de dois produtos, A e B, as informações de origem de dados podem ser obtidas de B no tempo de execução. Ao reconfigurar uma origem de dados, você muda propriedades como URI, nome de usuário, senha e quaisquer outras propriedades específicas da origem de dados utilizadas pelo Rational Publishing Engine ao extrair dados.

Antes de Iniciar

O elemento de configuração de origem de dados deve ser colocado no modelo de documento antes do elemento que contém as consultas para a origem de dados configurada.

Sobre Esta Tarefa

Use o elemento de configuração de origem de dados para reconfigurar a origem de dados. Um elemento de configuração de origem de dados deve estar conectado a um esquema da origem de dados que é usado no modelo. Dependendo da configuração da origem de dados, o elemento de origem de dados dinâmicos inclui propriedades semelhantes às propriedades na especificação do documento. No momento da geração de documento, esse elemento inicializa ou reinicializa a origem de dados. Use o elemento de configuração de origem de dados para definir apenas as propriedades que não são conhecidas no tempo de execução. Usar esse elemento para todas as propriedades, como o nome de usuário, senha, local dos arquivos exe, torna os modelos menos portáteis.

Embora as propriedades do elemento de configuração de origem de dados sejam semelhantes às definidas para o elemento de origem de dados na especificação do documento, as propriedades da especificação do documento possuem valores estáticos, enquanto as propriedades do elemento de configuração de origem de dados usam valores de outra origem de dados disponível em seu contexto.

Procedimento

  1. Na visualização Paleta, selecione o elemento ícone de Configuração de origem de dados Configuração de origem de dados e arraste-o no modelo.
  2. Selecione o elemento de configuração de origem de dados.
  3. Na visualização Propriedades, selecione a guia Dados.
  4. Na propriedade Origem de dados de destino, insira o nome do esquema da origem de dados. Depois que uma configuração de origem de dados é conectada a um esquema de origem de dados, suas propriedades de formatação são atualizadas para refletir as propriedades de tempo de execução do tipo de esquema de origem de dados.
  5. Na propriedade Configuração de dados herdada, insira o nome de um esquema de origem de dados usado no modelo. Por padrão, essa propriedade não contém um valor. É possível mudar esse valor com o nome do esquema da origem de dados que é usado no modelo. Se essa propriedade for usada, a origem de dados de destino será configurada usando as configurações obtidas da origem de dados herdada, juntamente com as propriedades definidas na configuração de origem de dados.

    As propriedades da origem de dados herdada são usadas quando um valor não é especificado para a origem de dados de destino. Por exemplo, a URL da origem de dados herdada é usada para a origem de dados de destino enquanto a propriedade de URL não é preenchida para a origem de dados de destino. Um uso comum para a propriedade de origem de dados herdada é fornecer as credenciais apenas uma vez para as origens de dados.

    Outras propriedades também podem ser especificadas ou obtidas de valores fornecidos na Especificação do documento ou origem de dados definida na propriedade origem de dados herdada.
    Nota: A origem de dados de destino e origem de dados herdada podem ser a mesma origem de dados. Se origem de dados herdada permanecer vazia, a origem de dados de destino será usada.

    A menos que a propriedade de configuração de origem de dados esteja vazia, ela terá precedência sobre a propriedade de especificação do documento. Rational Publishing Engine combina as propriedades definidas no elemento de configuração de origem de dados com aqueles definidos na especificação de documento.