Guia de administração para a integração do Portrait Dialogue 6.0. Versão 7.0A

Transcrição

1 Guia de administração para a integração do Portrait Dialogue 6.0 Versão 7.0A

2 2013 Pitney Bowes Software Inc. Todos os direitos reservados. Esse documento pode conter informações confidenciais ou protegidas por direitos autorais pertencentes à Pitney Bowes Inc. e/ou a seus subsidiários e suas empresas associadas. Portrait Software, o logotipo Portrait Software, Portrait e a marca Portrait Software s Portrait são marcas comerciais da Portrait Software International Limited e não podem ser usadas nem exploradas de forma alguma sem prévia autorização expressa por escrito da Portrait Software International Limited. Reconhecimento de marcas comerciais Outros nomes do produto, nomes, marcas, logotipos e símbolos da empresa referenciados aqui podem ser marcas comerciais ou marcas comerciais registradas de seus proprietários registrados. Suporte Portrait Software Se precisar de ajuda com algo que não se encontre nesses documentos, visite a Base de Conhecimentos em nosso site da Web. e siga os links para seu produto. Também é possível baixar outros documentos da Portrait Software a partir desse site. Se não tiver um nome de usuário e senha - ou se os esqueceu - contate-nos através de um dos canais abaixo. Se tiver algum problema com o uso, a instalação ou os documentos desse produto, contate-nos usando um dos seguintes métodos: support@portraitsoftware.com Telefone EUA/Canadá (número gratuito) Resto do mundo Quando estiver reportando um problema, ajuda se nos disser: O nome do aplicativo de software As circunstâncias em que o problema apareceu Que mensagens de erro você viu (se tiver visto alguma) A versão do software que você estava usando Pitney Bowes Software Inc. June 13, 2013

3 Sumário Capítulo 1: Introdução...5 Objetivo...6 Quem deve ler este manual...6 Documentos relacionados...6 Capítulo 2: Visão geral da integração do Miner...7 Visão geral da integração do Miner...8 Portrait Miner...8 Portrait Dialogue...8 Capítulo 3: Instalação do plug-in de exportação do Portrait Miner...9 Instalação do plug-in de exportação do Portrait Miner para PD...10 Capítulo 4: Configuração do servidor do Portrait Dialogue...13 Configuração do servidor do Portrait Dialogue...14 Capítulo 5: Teste e solução de problemas...15 Teste e solução de problemas...16

4

5 Capítulo 1 Introdução Nesta seção: Objetivo Quem deve ler este manual Documentos relacionados

6 Objetivo Objetivo Esse documento descreve como instalar o plug-in do Portrait Miner e o componente do serviço Web do PAWS que facilita a exportação de pontuações, listas e regras para o Portrait Dialogue. Quem deve ler este manual Os administradores do sistema que estão a instalar e gerenciar a integração entre o Portrait Miner e o Portrait Dialogue. Documentos relacionados Documento Mídia (zip/dvd) e localização Guia do usuário para a Mídia do Portrait Dialogue em: \Documentation\7 - Miner integração do Portrait Miner 7.0A Integration\ Guia de instalação do Portrait Dialogue 5.2 Mídia do Portrait Dialogue em: \Documentation\1 - Installation & upgrade\ Notas de versão do Portrait Dialogue 5.2 Mídia do Portrait Dialogue em: \Documentation\ Dica: Todos os documentos também se encontram disponíveis no site de suporte do Portrait Software: 6 Portrait Miner 7.0A

7 Capítulo 2 Visão geral da integração do Miner Nesta seção: Visão geral da integração do Miner

8 Visão geral da integração do Miner Visão geral da integração do Miner O Portrait Miner é uma solução da Portrait para gerar informações a partir da análise do comportamento do cliente; o Portrait Dialogue é uma solução de interação com o cliente que converte diferentes interações com o cliente em um diálogo bidirecional conectado a todos os canais para um maior compromisso com o cliente. A integração entre o Portrait Miner e o Portrait Dialogue permite a obtenção de resultados analíticos e informações, como grupos de segmentação e regras de segmentação preditivas, identificados no Portrait Miner para serem compartilhados e implementados diretamente em um ambiente operacional. Isso é efetuado por meio de uma escolha entre exportar uma lista de identificadores de clientes (e, opcionalmente, uma pontuação por cliente) ou exportar uma descrição de regra analítica. Portrait Miner Os seguintes pré-requisitos são necessários para a instalação dos componentes de plug-in para suportar a exportação de pontuações/listas do Portrait Miner para uma instalação Portrait Dialogue. O servidor/desktop Portrait Miner 7.0A está instalado. Um cliente SQL de linha de comando está instalado na máquina servidor/desktop onde o plug-in vai ser instalado (por exemplo, sqlcmd para SQL Server ou sqlplus para Oracle) e é possível ser executado por todos os usuários do servidor/desktop Portrait Miner. A máquina servidor/desktop Portrait Miner e o banco de dados do servidor do Portrait Dialogue têm acesso a um sistema de arquivos comuns, onde tanto o usuário que exporta como o usuário do sistema de banco de dados têm permissão de leitura/gravação. O servidor de banco de dados do Portrait Dialogue está em uma rede visível a todos os usuários do servidor/desktop Portrait Miner. O usuário que faz a instalação tem acesso a um editor de textos simples no computador de instalação do servidor/desktop do Portrait Miner. Portrait Dialogue Os seguintes pré-requisitos são necessários para um uso bem-sucedido do plug-in. Portrait Dialogue 5.2 instalado. O Portrait Dialogue tem de estar em execução em um banco de dados que não diferencia maiúsculas e minúsculas. O servidor de banco de dados do Portrait Dialogue e a máquina servidor/desktop Portrait Miner têm acesso a um sistema de arquivos comuns, onde tanto o usuário que exporta como o usuário do sistema de banco de dados têm permissão de leitura/gravação. Para usar qualquer categoria exportada, é necessário que o grupo de dados de sistema das Categorias esteja presente no domínio de cliente para onde as categorias estão sendo exportadas. Observação: O SQL Server 2000 já não é mais um banco de dados suportado para o recurso de exportação. 8 Portrait Miner 7.0A

9 Capítulo 3 Instalação do plug-in de exportação do Portrait Miner Nesta seção: Instalação do plug-in de exportação do Portrait Miner para PD

10 Instalação do plug-in de exportação do Portrait Miner para PD Instalação do plug-in de exportação do Portrait Miner para PD Os componentes de extensão do servidor do Portrait Miner serão fornecidos em uma pasta na versão em DVD. Para instalar o componente, faça o seguinte: Copie a pasta millionhandshakes do DVD da versão, (\5.2\5.0.x.xx\Miner Integration\Miner7.0A\Portrait Miner Export to Portrait Dialogue Plug-in 1.3A\) para o diretório "'ext" da instalação do Portrait Miner, isto é, se a instalação do Portrait Miner 7.0A estiver em C:\PortraitMiner_7.0A, copie a pasta de componentes para C:\PortraitMiner_7.0A\ext. Localize a nova pasta de componentes millionhandshakes (C:\PortraitMiner_7.0A\ext\millionhandshakes), abra o arquivo javastartup.xml e configure os valores de sua instalação para as seguintes propriedades: Propriedade MH_DATABASE_TYPE Descrição O tipo de banco de dados no qual o Portrait Dialogue está instalado (deve ser um de MSSQL2005 ou ORACLE). Observação: Para o servidor de banco de dados SQL Server 2008 deve-se digitar MSSQL2005. MH_INSTANCE MH_USERNAME MH_PASSWORD MH_WH_BASE_URL O nome da instância do Portrait Dialogue (isto é, o nome do banco de dados mostrado na janela de logon do Visual Dialogue) para onde esta instalação será exportada. O nome de usuário do Portrait Dialogue (isto é, o nome de usuário usado para entrar no Visual Dialogue) sob o qual serão realizadas todas as exportações. A senha para o usuário acima (isto é, a senha usada para entrar no Visual Dialogue). Essa é a URL base para os serviços Web do Portrait Dialogue, sendo normalmente: Observação: A URL deve terminar com uma '/'. MH_EXPORT_DIR O caminho para um diretório para o qual essa instalação irá exportar seus dados. Normalmente, será um diretório no compartilhamento do Portrait Dialogue padrão como um caminho UNC, por exemplo, \\<<MHServerName>\MH\Imports, apesar de também poder ser uma unidade mapeada. O ponto importante é que essa 10 Portrait Miner 7.0A

11 Capítulo 3: Instalação do plug-in de exportação do Portrait Miner Propriedade Descrição localização precisa ser visível para o servidor do Portrait Miner e o servidor de banco de dados do Portrait Dialogue (por isso, é recomendado um caminho UNC). MH_IMPORT_DIR Este é o caminho para o diretório que o servidor de banco de dados do Portrait Dialogue irá pesquisar para localizar os arquivos contendo os dados a importar. Normalmente, será a mesma localização UNC que MH_EXPORT_DIR, mas é possível ter um nome diferente, desde que ambos apontem para a mesma localização física no disco. Observação: Para o sistema Portrait Dialogue usando Oracle, esse valor não é usado e a localização de exportação deve ser para um diretório Oracle definido, chamado MH_IMPORT. MH_IMPORT_SQL_CMD A linha de comando de cliente SQL para SQL Server 2005/2008: sqlcmd /U <user> /P <passwd> /S <server> /i ~FILE~ Observação: Observação: Pode ser necessário especificar /d database se o banco de dados do Portrait Dialogue não for seu padrão. Se estiver usando a Autenticação do Windows para se conectar ao banco de dados, omita as opções /U e /P. A linha de comando do cliente SQL para Oracle: sqlplus <user>/<passwd>@<server>@~file~ Observação: ~FILE~ deve estar presente na linha de comando (será substituído pelo nome de um arquivo SQL gerado dinamicamente ao executar a exportação). Observação: É necessária que a ferramenta de linha de comando esteja no caminho do usuário que faz a exportação ou deverá ser usado o caminho completo para o utilitário da linha de comando. É necessário também que o usuário tenha as permissões de sistema de arquivo adequadas para que possa executar a ferramenta. Observação: As contas de usuário especificadas na linha de comando deverão ter as permissões adequadas, Guia de administração para a integração do Portrait Dialogue

12 Instalação do plug-in de exportação do Portrait Miner para PD Propriedade Descrição por exemplo, para o SQL Server, o usuário deve ter a função bulkadmin. Em uma linha de comando, assegure que o diretório de bin do Portrait Miner está no caminho executando o seguinte script: <PMHOME>/config/setpath-qs7.0A.bat Depois, execute o seguinte para tornar o DBC disponível: qsextadmin enable millionhandshakes Reinicie o serviço Portrait Miner Server (Quadstone System Server qs7.0a) com Painel de controle > Ferramentas administrativas > Serviços 12 Portrait Miner 7.0A

13 Capítulo 4 Configuração do servidor do Portrait Dialogue Nesta seção: Configuração do servidor do Portrait Dialogue

14 Configuração do servidor do Portrait Dialogue Configuração do servidor do Portrait Dialogue No servidor de banco de dados, crie um diretório compartilhado que ficará visível aos usuários do Portrait Miner e no qual terão permissão de leitura/gravação (como descrito nas notas de instalação do Portrait Miner para MH_IMPORT_DIR). Esse diretório será usado para receber as pontuações e listas exportadas do Portrait Miner. Observação: Em um servidor Oracle, é necessário que esse diretório também esteja registrado com o servidor de banco de dados Oracle, usando o seguinte comando SQL: CREATE OR REPLACE DIRECTORY MH_IMPORT AS [import directory] ; GRANT READ, WRITE ON DIRECTORY MH_IMPORT TO [db user in the SQL command]; O comando acima não suporta o uso de nomes de caminho UNC. 14 Portrait Miner 7.0A

15 Capítulo 5 Teste e solução de problemas Nesta seção: Teste e solução de problemas

16 Teste e solução de problemas Teste e solução de problemas Para testar a instalação, Inicie o Decision Studio, Carregue um foco e abra o Table Viewer. Os ícones Exportar pontuações para o Portrait Dialogue e Exportar pontuações para o Portrait Dialogue deverão estar visíveis na barra de ferramentas, Clicando no ícone "Exportar lista" deverá exibir o diálogo de exportação com os domínios disponíveis listados na lista suspensa. Se alguma categoria estiver definida no domínio selecionado, o botão de opção Atualizar deverá estar ativado e, se selecionado, a lista de categorias deverá ser exibida na lista suspensa de categorias. Para testar a nova Categoria no Portrait Dialogue, crie uma nova Seleção usando a Categoria recém-exportada. Se a instalação não funcionar corretamente, comece por examinar os arquivos de log em <PMHOME>/shared/logs (em especial, o log de sessão do Decision Studio), onde <PMHOME> é o diretório que contém a instalação do Portrait Miner. Se não acontecer nada após clicar no ícone "Exportar lista", verifique se o serviço Portrait Miner qs7.0a foi reiniciado no servidor. 16 Portrait Miner 7.0A