Gerenciamento de dados e programas de configuração

Por padrão, o PPM Customizing Toolkit disponibiliza vários aplicativos que facilitam a configuração e o gerenciamento dos dados do cliente do PPM.

Esses programas são armazenados como scripts em lotes no diretório bat do cliente do PPM. Os aplicativos disponíveis dependem da configuração do cliente. Os scripts padrão disponíveis apresentam uma configuração independente do cliente e podem, portanto, ser usados para qualquer cliente.

Dependendo da configuração do PPM Customizing Toolkit, os aplicativos correspondentes estão disponíveis no componente Programas do módulo Cliente.

Todos os programas executam em primeiro lugar o arquivo de script _param.bat. Esse arquivo define variáveis de ambiente que são usadas como argumentos nos arquivos de programa. Para maior clareza, os nomes de todas as variáveis de ambiente começam com a cadeia de caracteres PPM_CONF_.

O arquivo _param.bat é automaticamente gerido pelo PPM Customizing Toolkit. Alterações manuais no arquivo _param.bat não são avaliadas pelo PPM Customizing Toolkit, mas substituídas pelas informações do componente Programas.

Pedido de senha

Para executar alguns programas, necessita de direitos de acesso para o servidor cliente do PPM correspondente. Antes de o programa ser iniciado pela primeira vez, é solicitada uma senha. A senha é válida apenas para o cliente atual e para a duração da sessão do PPM Customizing Toolkit em curso. Essa é a senha que usada para efetuar logon no cliente do PPM.

Na guia Configurar programas da coluna Senha obrigatória, pode especificar se uma senha será necessária ou não para executar programas individuais.

Pode alterar uma senha errada mais tarde. Para isso, clique no botão Alterar senha da guia Executar programa e insira a senha correta.

Para configurações do cliente que foram criadas com uma versão do CTK anterior a 4.1.2, não é possível exibir a coluna Senha obrigatória. Para visualizar a coluna, acesse a guia Configurar parâmetros, exclua a entrada PPM_CONF_PASSWD e salve a configuração.

Lista de parâmetros padrão disponíveis

Os parâmetros seguintes estão disponíveis para a configuração de scripts, se tiver selecionado o modelo base para o cliente.

%PPM_CUSTOM_DIR% => <PPM installation directory>\ppm\server\bin\work\data_ppm\custom\

Nome da variável de ambiente

Descrição

PPM_CONF_DIMDATACSV_FILE

Arquivos a serem importados quando o programa Importar valor de dimensão como CSV é chamado.

Valor padrão: %PPM_CUSTOM_DIR%\data\dimdata\*.csv

PPM_CONF_DIMDATAXML_FILE

Arquivos a serem importados quando o programa Importar valor de dimensão como XML é chamado.

Valor padrão: %PPM_CUSTOM_DIR%\data\dimdata\*.xml

PPM_CONF_EXPORTPATH

Diretório para o qual uma configuração é salva usando os programas Exportar configurações do PPM ou Importar configurações do PPM.

PPM_CONF_IMPORT_MODE

Opção no programa Importar configurações do PPM. Valores válidos: -overwrite ou -replace para substituir configurações existentes.

PPM_CONF_INITDB_OVERWRITE

Define se o conteúdo existente deve ser substituído (= -overwrite) ou não (sem valor) quando Inicializar o banco de dados é chamado.

PPM_CONF_JDBC_PARAMS

Opções aplicadas quando o extrator JDBC2PPM é executado

PPM_CONF_LANGUAGE

Parâmetro de idioma para comandos do PPM

PPM_CONF_SAP_PARAMS

Opções aplicadas quando o extrator SAP2PPM é executado

PPM_CONF_PASSWD

Senha do usuário do PPM

PPM_CONF_PIKICSV_FILE

Arquivos a serem importados quando o programa Importar medidas independentes da instância de processo como CSV é chamado.

Valor padrão: %PPM_CUSTOM_DIR%\data\piki\*.csv

PPM_CONF_PIKIXLS_FILE

Arquivos a serem importados quando o programa Importar medidas independentes da instância de processo do Excel é chamado.

Valor padrão: %PPM_CUSTOM_DIR%\data\piki\*.xls

PPM_CONF_PIKIXML_FILE

Arquivos a serem importados quando o programa Importar medidas independentes da instância de processo como XML é chamado.

Valor padrão: %PPM_CUSTOM_DIR%\data\piki\*.xml

PPM_CONF_PROTOCOL_ERROR

Sinaliza se os erros de ferramenta do PPM devem ser registrados ou não.

Valores válidos:

yes: Os erros são registrados

no: Os erros não são registrados

PPM_CONF_PROTOCOL_INFO

Sinaliza se a saída de informações de ferramenta do PPM devem ser registrados ou não.

Valores válidos:

yes: As informações são registradas

no: As informações não são registradas

PPM_CONF_PROTOCOL_WARNING

Sinaliza se os avisos de ferramenta do PPM devem ser registrados ou não.

Valores válidos:

yes: Os avisos são registrados

no: Os avisos não são registrados

PPM_CONF_USER

usuário do PPM usado para executar comandos do PPM

PPM_CONF_UPDATE_RECOVERY_FILE

Arquivo de recuperação do servidor de análise para operações de importação de dados

Valores válidos:

yes: atualiza sempre

no: nunca atualiza

PPM_CONF_MAKEZIP_DIR

Diretório de destino para arquivamento do cliente

Valor padrão:

<PPM installation directory>\server\bin\work\data_ppm\custom\archive

PPM_CONF_PIKIEXPORT_FILE

Arquivo a ser usado para exportação quando o programa Importar medidas independentes da instância de processo como XML é chamado.

Valor padrão:

%PPM_CUSTOM_DIR%\data\piki\piki_export.xml

PPM_CONF_AS_STARTEMPTY

Especifica se é usado um dump ao chamar Iniciar servidor de análise.

Valores válidos:

startempty: Dump não é usado

No value: Dump é usado

PPM_CONF_CONVERTER_CHECK

Especifica se apenas a versão do banco de dados é verificada ao chamar Converter banco de dados do PPM.

Valores válidos:

check: É verificado

No value: É convertido

PPM_CONF_CONVERTER_IGNOREPIKIDATA

Especifica se são considerados os cubos PIKI existentes ao chamar Converter o banco de dados do PPM.

Valores válidos:

No value: O conversor não é iniciado se ainda existirem cubos PIKI no banco de dados

ignorepikidata: Os cubos PIKI existentes serão excluídos.

Na fase de desenvolvimento do projeto, associe o valor -overwrite ao parâmetro PPM_CONF_INITDB_OVERWRITE para permitir que o banco de dados seja inicializado novamente usando o comando runinitdb. Quando a fase de desenvolvimento estiver concluída, reinicie o valor para evitar que o banco de dados seja substituído acidentalmente.

Lista de programas padrão disponíveis

A lista seguinte contém uma seleção de programas padrão disponíveis no PPM Customizing Toolkit, caso tenha selecionado base como modelo para o cliente.

Programa

Arquivo de script

Descrição

Personalização

 

 

Recalcular medidas

keyindicatornew.bat

Recalcula todas as medidas e dimensões do cliente.

Ativar a configuração do módulo Atributos

activate_attributes.bat

Importa todas as configurações editadas no módulo Atributos para o cliente.

Ativar a configuração do módulo Medidas e dimensões

activate_ki.bat

Importa todas as configurações editadas no módulo Medidas e dimensões para o cliente. Como novos atributos também podem ser importados, todas as configurações do módulo Atributos são importadas, de modo a garantir que a configuração é importada corretamente.

Ativar a configuração do módulo Merge

activate_merger.bat

Importa todas as configurações editadas no módulo Merge do processo para o cliente. Como novos atributos também podem ser importados, todas as configurações do módulo Atributos são importadas, de modo a garantir que a configuração é importada corretamente.

Ativar a configuração do módulo Processos

activate_ptree.bat

Importa todas as configurações editadas no módulo Processos para o cliente. Como novos atributos, medidas e dimensões também podem ser importados, todas as configurações dos módulos Atributos e Medidas e dimensões são importadas, de modo a garantir que a configuração é importada corretamente.

Importar

 

 

Inicializar o banco de dados

runinitdb.bat

Reinicializa o banco de dados do cliente se o banco de dados estiver vazio. Se a variável PPM_CONF_INITDB_OVERWRITE=-overwrite tiver sido definida, o banco de dados existente será substituído.

Aviso

Todos os dados serão perdidos.

Além disso, todos os arquivos de log no diretório log são excluídos antes da inicialização.

Sistema

 

 

Reinicializar o servidor de análise do PPM

initanalysisserver.bat

Reinicializa o servidor de análise do cliente do PPM

Iniciar o cliente PPM

rungui.bat

Inicia o PPM sem um browser

Criar novas senhas de usuário

renew_userpasswords.bat

Cria novas senhas aleatórias para todos os usuários no gerenciamento central de usuários e os envia por email para os respetivos usuários.

Executar a automação de relatório

startreportautomation.bat

Este programa inicia a automação de relatório. Para chamá-lo, deve especificar o nome de usuário e senha de um usuário com o direito do usuário Gerenciamento de relatórios. No entanto, as automações de relatório são executadas sob a conta do usuário com a qual elas estão associadas.

Iniciar os servidores do PPM e o servidor de análise

startup.bat

Inicia o servidor do PPM do cliente e o servidor de análise associado

Desliga os servidores do PPM e o servidor de análise

shutdown.bat

Desliga o servidor do PPM do cliente e o servidor de análise associado

Desligar o servidor do PPM

stopserver.bat

Desliga o servidor do cliente do PPM

Executar o servidor do PPM

runserver.bat

Inicia o servidor do cliente do PPM

Atualizar o arquivo de recuperação do servidor de análise do PPM

update_recoveryfile.bat

Atualiza os arquivos de recuperação do servidor de análise do PPM

Outro

 

 

Desligar o servidor de análise do PPM

stopanalysisserver.bat

Desliga o servidor de análise do cliente do PPM

Liga o servidor de análise do PPM

runanalysisserver.bat

Liga o servidor de análise do cliente do PPM

Iniciar análise de desvio suspeito

ppmanalytics.bat

Este programa executa uma análise de desvio suspeito para os dados atuais do cliente. O resultado da análise é enviado para os usuários com os direitos correspondentes.

Criar documentação do cliente

createdocu.bat

Cria documentação para as medidas e dimensões em formato HTML a partir da configuração atual do cliente (os arquivos de configuração no diretório xml). O resultado é armazenado no diretório docu em <client>.html e pode ser copiado para o servidor Web do <PPM> usando o programa <Publish.

Anonimizar unidades organizacionais

anonymize_orgunits.bat

Anonimiza unidades organizacionais

Exportar atributos do PPM

exportattributes.bat

Exporta atributos do PPM para o diretório PPM_CONF_EXPORTPATH. Os nomes de atributos não são exportados. O diretório XML do cliente é o diretório padrão, isto é, os arquivos de configuração existentes são substituídos.

Converter o banco de dados do PPM

runppmconverter.bat

Converte um banco de dados do PPM existente. Se a variável PPM_CONF_CONVERTER_CHECK=-check estiver definida, o sistema verifica se o banco de dados deve ser convertido ou se está atualizado.

Exportar a árvore de processos do PPM

exportprocesstree.bat

Exporta a árvore de processos do banco de dados do PPM para um arquivo.

Processos de merge e medidas de cálculo

ppmimport.bat

Efetua o merge dos dados do processo importados e calcula as medidas e dimensões.

Arquivamento ZIP de um cliente

make_zip.bat

Arquiva os conteúdos de um diretório do cliente em um arquivo ZIP.

Exportar a configuração do PPM

exportconfig.bat

Exporta uma seleção de configurações definida pelo usuário para o diretório PPM_CONF_EXPORTPATH. Isso é feito comentando as linhas correspondentes no arquivo de entrada e saída. Por padrão, todas as configurações são exportadas para o diretório XML do cliente. Todos os arquivos de configuração existentes são substituídos.

Importar dados de dimensão em formato CSV

dimdataimport_csv.bat

Importa todos os dados de dimensão do diretório PPM_CONF_DIMDATACSV_FILE (por padrão, em <client>/data/dimdata) em formato CSV (*.cvs) com <; como separador.

Importar dados de dimensão em formato XML

dimdataimport_xml.bat

Importa todos os dados de dimensão do diretório PPM_CONF_DIMDATAXML_FILE (por padrão, em <client>/data/dimdata) em formato XML (*.xml).

Criar documentação do cliente com visão geral da função

createfuncdocu.bat

Cria documentação técnica para as medidas, dimensões, processos e funções do cliente. O resultado é armazenado no diretório docu em <client>.html e pode ser copiado para o servidor Web do PPM usando o programa Publish. Os dados são extraídos do cliente, ou seja, o servidor do cliente têm de estar em execução.

Criar documentação técnica do cliente

createtechdocu.bat

Cria documentação técnica para as medidas e dimensões em formato HTML a partir da configuração atual do cliente (os arquivos de configuração no diretório xml). O resultado é armazenado no diretório docu em <client>_tech.html.

Importar medidas independentes da instância de processo como CSV

pikiimport_csv.bat

Importa toda a série de medidas independentes da instância de processo do diretório PPM_CONF_PIKICSV_FILE (por padrão, em <client>/data/piki) em formato CSV (*.csv).

Importar medidas independentes da instância de processo como XML

pikiimport_xml.bat

Importa toda a série de medidas independentes da instância de processo do diretório PPM_CONF_PIKIXML_FILE (por padrão, em <client>/data/piki) em formato XML (*.xml).

Importar medidas independentes da instância de processo do Excel

pikiimport_xml.bat

Importa toda a série de medidas independentes da instância de processo do diretório PPM_CONF_PIKIXLS_FILE (por padrão, em <client>/data/piki) em formato XLS (*.xls).

Publicar documentação

publish.bat

Copia dados do diretório custom para os diretórios de instalação do PPM correspondentes:

Relatórios do diretório reports

Documentação do cliente, do diretório docu

Importar configurações específicas do PPM

importconfig.bat

Importa uma seleção de configurações definidas pelo usuário. Isso é feito comentando as linhas correspondentes no arquivo de entrada e saída.

Exportar medidas independentes da instância de processo como XML

piki_export.bat

Esse programa exporta toda a série de medidas independentes da instância de processo em formato XML (*.xml) para o arquivo PPM_CONF_PIKIEXPORT_FILE.

Pode adicionar mais programas disponíveis à lista. Para isso, selecione os programas relevantes na guia Configurar programas. Quando volta a abrir o componente Programas, os programas selecionados são exibidos na lista Grupos de programas.

Pode transferir qualquer um dos programas da lista para a barra de inicialização rápida. Isso permite executar programas usados com frequência apenas clicando neles. Clique em bookmark_16.png Editar programas favoritos para executar o componente de administração correspondente.

Se quiser modificar determinados scripts para um cliente, poderá configurar os programas adequadamente e definir seus próprios parâmetros. Todos os parâmetros do script em lotes são definidos no arquivo _param.bat do diretório do cliente bat, que todo script em lotes acessa quando é executado.

Pode encontrar uma lista dos parâmetros usados por um script na descrição do programa em causa.

Pode definir os parâmetros de script na guia Configurar parâmetros.

Adicionar programas personalizados

Também pode escrever seus próprios aplicativos e disponibilizá-los em seu cliente. O nome do arquivo do aplicativo não deve começar com um sublinhado, por exemplo, _myprogram.bat.

Salve o script personalizado no diretório bat do cliente (<PPM installation directory>\server\bin\work\data_ppm\custom\<client>\bat). Quando volta a abrir o componente Programas, a aplicação será exibida na lista Grupos de programas.

Veja também

Passo 3: Configurar e gerenciar programas usados pelo cliente

Diretrizes para criar scripts personalizados

Em seguida use o prompt de comando pushd para acessar o diretório bin da instalação do PPM, onde pode executar qualquer programa de linha de comando a partir do sistema PPM. Antes de abandonar o script, use o comando popd para redefinir o diretório de trabalho original.

Quando executa um programa de linha de comando do PPM, a saída echo é ativada. Desative imediatamente esta opção após chamar o programa de linha de comando usando o comando @echo off (o caractere @ também suprime a saída do próprio comando echo).

Exemplo

O exemplo abaixo mostra o arquivo de script rungui.bat, no qual as diretrizes descritas podem ser facilmente identificadas.

@echo off

REM **********************************************************

REM ...

REM **********************************************************

REM variáveis globais

call _init.bat

REM faça backup do diretório atual e mude para PPM_HOME

pushd C:\SoftwareAG\ppm\server\bin\work\data_ppm\bin

REM iniciar o GUI do PPM para o cliente

@echo on

call runppmgui -language %PPM_CONF_LANGUAGE% -user %PPM_CONF_USER% -password %PPM_CONF_PASSWD% -client %PPM_CLIENT%

@echo off

REM diretório para restaurar

popd