Com o conector IBM® Planning Analytics® TM1®, você pode usar os comandos em uma cadeia para interagir com o IBM Planning Analytics, desenvolvido pelo Cognos® TM1. Por exemplo, com esse conector, você pode:
- Gerenciar tarefas e suas tarefas no Planning Analytics
- Gerenciar cubos TM1, visualizações de cubo e células
- Filtrar logs de mensagens e transações
- Gerenciar processos e seus logs de erros
Observação: Esse conector foi criado pela Workiva e se conecta a um sistema de terceiros. Embora nossa equipe de suporte possa ajudar a configurar esse conector no seu espaço de trabalho, não podemos solucionar problemas ou ajudar com problemas que se originem fora da plataforma Workiva.
Pré-requisitos
Para habilitar a conexão, o conector usa a API REST do IBM Planning Analytics. Observação: O conector é compatível com o IBM Planning Analytics versão 10.2 ou superior.
Para configurar a conexão, você precisará de:
- A URL completa da instância do TM1 à qual você deve se conectar, como
https://TM1-url.com/api/v1 - Uma conta de serviço designada configurada na instância do TM1 para o conector
- O nome de usuário e a senha da conta de serviço
- Credenciais de autenticação adicionais para o servidor TM1, se Integrated Windows@ authentication (IWA) ou Cognos Authentication Manager (CAM) estiver ativado
- Se o IWA estiver ativado, seu token de autenticação
- Se o CAM estiver ativado, seu namespace LDAP (Lightweight Directory Access Protocol)
- Para se conectar a um servidor TM1 local, o GroundRunner para executar os comandos
Observação: Para se conectar a uma instância de nuvem do TM1, use o CloudRunner padrão.
Configure o conector do IBM Planning Analytics TM1
Observação: Para tornar o conector disponível para uso nas cadeias de sua organização, um administrador de segurança da organização primeiro o habilita em Configuração.
- Em Construtor de cadeia, clique em Conexões e, em seguida, Criar no canto superior direito.
- Em Connector Connection, selecione IBM Planning Analytics TM1 e o executor a ser usado com o conector.
- Em Informações básicas, digite um nome e uma descrição exclusivos para ajudar a identificar a conexão.
- Em Propriedades, digite os detalhes da conexão:
Propriedade Detalhes URL da API do TM1 Digite o URL completo da instância do TM1 à qual você deseja se conectar, como https://TM1-url.com/api/v1.Nome de usuário Digite o nome de usuário da conta de serviço do conector na instância do TM1. Senha Digite a senha da propriedade Nome de usuário. Token Se a autenticação integrada do Windows (IWA) estiver ativada para o servidor TM1, digite seu token de autenticação. Tipo de autenticação Selecione o tipo de autenticação ativado para o servidor TM1: - Autenticação básica, somente para autenticação de nome de usuário e senha do TM1
- Autenticação integrada do Windows, se o IWA estiver ativado
- Se a segurança do Cognos estiver ativada, você poderá usar o Cognos Authentication Manager (CAM)
Espaço de nomes LDAP Se o CAM estiver ativado, insira seu espaço de nome LDAP. Observação: Todas as credenciais confidenciais são automaticamente criptografadas e armazenadas com criptografia Advanced Encryption Standard (AES) 256.
- Selecione os ambientes para usar a conexão e clique em Save.
- Para testar a conexão, crie e execute uma cadeia com o comando Listar arquivos do conector e verifique se ele retorna uma saída válida.
Solução de problemas
Se a conexão com o IBM Planning Analytics falhar:
- Verifique o URL da instância do TM1 à qual você deve se conectar.
- Verifique as credenciais de autenticação da conta do serviço da Web.
- Verifique o tipo de autenticação ativada para o servidor TM1 e suas credenciais relacionadas, como o token IWA ou o espaço de nomes LDAP
Se você receber o erro Unable to find valid certification path to requested target, adicione o certificado do servidor ao seu repositório de chaves Java® confiável:
- Para obter o certificado do servidor, digite este comando:
# openssl s_client -connect tm1server.tux:5010 -servername tm1server.tux:5010 <> public.crt
- Para importar o certificado para seu repositório de chaves, digite este comando:
# /usr/lib/jvm/java-8-openjdk-amd64$ sudo bin/keytool -import -alias tm1server.tux -keystore jre/lib/security/cacerts -file /home/administrator/public.crt
Observação: A senha do seu keystore pode ser
changeit.