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 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.
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