Importar parâmetros de versão para o Pentaho como parâmetros de dimensão
Quando um carregador de scripts ou fonte de dados com script inclui parâmetros, eles são normalmente passados para o Pentaho como variáveis de ambiente. Os parâmetros de versão não podem ser passados ao Pentaho como variáveis de ambiente. Você deve passar os parâmetros de versão ao agente como parâmetros de dimensão. Depois que um parâmetro de dimensão de uma versão é criado, para que ele possa ser escolhido em tempo de execução, você deve incluí-lo na lista de versões.
- Crie um novo parâmetro de dimensão na fonte de dados com script.

- Informe um nome de exibição para o parâmetro, como por exemplo, Versão do Planning a ser carregada.
- Selecione o membro que deve estar dentro da dimensão escolhida. Selecionar o nó de nível superior da dimensão da versão é o mesmo que selecionar o valor por padrão da dimensão da versão do Planning.

- O designer de dados pode associar o parâmetro da dimensão a carregadores de scripts específicos e fontes de dados com script específicas, arrastando o parâmetro até a área Parâmetros.

- Se uma fonte de dados com script tem um parâmetro de dimensão associado a ela, quando o usuário clica emImportar dadosna tela do designer de dados, é solicitado o membro selecionado na etapa 3. O valor por padrão pode ser substituído ao escolher uma versão diferente. O mesmo comportamento existe na Integração, na tela de tarefas de inicialização do operador de integração.

- se a dimensão selecionada é a Versão do Planning, um valor especial [Default Version] é incluído. Isso significa usar a versão por padrão do aplicativo de planejamento atualmente selecionada. Os membros de estilo de pasta da árvore de dimensões não podem ser selecionados se a Versão do Planning é selecionada.
- Se o script do Pentaho Kettle é executado, o ambiente do Kettle tem três variáveis disponíveis para cada um dos Parâmetros de dimensão: <display name>.DimensionIsSelected, <display name>.DimensionName, <display name>.MemberName. O script do Pentaho Kettle pode usá-los conforme aplicável.
Parâmetro de versão de dimensão em um exemplo de fonte de dados com script
No exemplo a seguir, Versão do Planning a ser carregada é o nome de exibição do parâmetro conforme configurado no designer de dados da etapa 2.
- Versão do Planning a ser carregada.MemberName: nome de exibição do membro selecionado.
- Se o membro do nível raiz (a própria dimensão) é selecionado, este valor fica em branco.
- Versão do Planning a ser carregada.DimensionName: nome de exibição da dimensão associada ao parâmetro.
- Versão do Planning a ser carregada.DimensionIsSelected: contem o valor verdadeiro ou falso e indica se o membro selecionado é o membro do nível raiz, que é a própria dimensão.

Um uso comum do valor de dimensão de versão seria em um
Adaptive Planning
Etapa de saída no Spoon, conforme mostrado abaixo.