Guia do Administrador do IBM SmartCloud for Social

Transcrição

Guia do Administrador do
IBM SmartCloud for Social Business
IBM SmartCloud Engage e do IBM
SmartCloud Connections
Guia do Administrador do
IBM SmartCloud for Social Business
IBM SmartCloud Engage e do IBM
Nota
Antes de usar estas informações e o produto que elas suportam, leia as informações em “Avisos” na página 123.
Aviso
Esta edição se aplica ao IBM SmartCloud Engage de novembro de 2013 e ao IBM SmartCloud Connections de
novembro de 2013 e a todas as liberações e modificações subsequentes até que seja indicado o contrário em novas
edições.
© Copyright IBM Corporation 2010, 2013.
Capítulo 1. Administração
Integre a rede social e a colaboração online em um conjunto de ferramentas disponíveis na web. Um
Responsável pelo Atendimento ao Cliente IBM® pode ajudá-lo na seleção dos serviços de correio e de
colaboração que são mais adequados a seus negócios.
Para obter informações adicionais sobre os serviços oferecidos, acesse IBM SmartCloud for Social Business
e clique em What Can I Do?.
O que Há de Novo na Administração do IBM SmartCloud for Social Business?
Descubra quais recursos foram incluídos desde a última atualização.
Iniciar o Aprendizado sobre um Serviço
SmartCloud Engage ou SmartCloud Connections
Use os serviços em nuvem para criar comunidades, atividades ou compartilhar arquivos entre
membros de sua organização. Configure sua conta da organização, que representa seu site no
IBM SmartCloud for Social Business. É possível customizar a aparência de sua organização para
que seus usuários a associem à sua empresa. Ou, é possível especificar configurações de
segurança para senhas ou configurar variações de endereços IP.
Ambiente Híbrido do SmartCloud Notes
Os ambientes híbridos combinam serviços em nuvem com ferramentas locais. Planeje, configure e
administre o SmartCloud Notes em um ambiente híbrido usando as ferramentas locais com as
quais você está familiarizado.
Ambiente Apenas de Serviço do SmartCloud Notes
Em um ambiente apenas de serviço, os servidores Domino estão na nuvem. As tarefas de
administração de usuário incluem gerenciar contas, usuários e grupos. Para executar essas tarefas,
você deve ser designado à função de Administrador.
IBM SmartCloud iNotes
Insira e verifique o nome de domínio da sua organização. Em seguida, é possível configurar as
definições da organização, gerenciar email e contatos e enviar anúncios por email para seus
usuários.
© Copyright IBM Corp. 2010, 2013
1
2
Guia do Administrador do IBM SmartCloud for Social Business: IBM SmartCloud Engage e do IBM SmartCloud Connections
Capítulo 2. Administrando o SmartCloud Engage ou o
Configure a conta da organização. Conheça o site clicando em Administração > Mapa do Site
Administrativo na barra de navegação e revisando o mapa do site.
v Altere a aparência da sua organização. Escolha entre os esquemas de cores disponíveis ou crie um
esquema de cores customizado. Altere o logotipo na barra de navegação.
v Configure as definições da conta da organização. Atualize as configurações de segurança, incluindo
expiração de senha para seus usuários e restrições de faixa de endereço IP. Especifique quem é listado
no diretório público e gerencie assinaturas.
v Inclua usuários. Antes de um usuário possa acessar a organização, uma conta deve ser criada para ele.
v Crie um anúncio de boas-vindas. Forneça aos novos usuários as informações que eles precisam. Por
exemplo, liste as melhores práticas da organização para uso de aplicativos ou diretrizes de
compartilhamento de arquivo. É possível também incluir com quem o usuário entra em contato para
obter suporte.
Informações relacionadas:
Introdução ao IBM SmartCloud Engage para Administradores (abre uma nova janela)
3
4
Capítulo 3. Requisitos do Sistema
Revise os requisitos do sistema para usar o IBM SmartCloud for Social Business.
Requisitos do Sistema (abre uma nova janela)
5
6
Capítulo 4. Customizando sua Organização
Os administradores podem alterar a aparência e o comportamento de sua organização. Projete uma
página de organização, configure um esquema de cores padrão, inclua campos em perfis de usuário e
atualize as suas configurações pessoais.
Projetando a Página da sua Organização
Crie uma página pública que represente a sua organização. Inclua informações de contato e uma curta
descrição.
Sobre Esta Tarefa
Essa função está disponível para assinaturas de colaboração. Você deve ter efetuado login com uma conta
do administrador para alterar essas configurações.
Procedimento
1. Clique no nome da sua organização na barra de navegação para chegar na página da organização.
2. Clique em Editar Informações.
a. Inclua ou modifique informações gerais sobre a organização. Por exemplo, grave um título que
seja exibido do nome da organização, insira uma breve descrição da organização, informações de
contato e o website da organização.
b. Clique em Alterar para substituir o gráfico padrão por um gráfico customizado transferido por
upload.
3. Clique em Customizar Tema da Organização para alterar a aparência e o comportamento de sua
organização. Selecione Alterar para o que você deseja modificar. Altere o esquema de cores,
escolhendo a partir de um tema padrão. Também é possível selecionar uma opção de arco-íris para
especificar as cores para os elementos individuais. Além disso, inclua um logotipo para a barra de
navegação ou selecione para ocultar uma imagem. Essas mudanças afetam a aparência e o
comportamento de todos os seus usuários.
Conceitos relacionados:
“Customizando a Identidade de sua Marca” na página 11
Como fornecedor, é possível customizar as informações exibidas quando os clientes efetuam login em sua
organização. Reformular a marca das telas que os clientes veem identifica o site com sua organização.
Tarefas relacionadas:
“Incluindo Logotipo na Barra de Navegação”
Customize o site incluindo o logotipo da sua organização na barra de navegação. A customização do
logotipo da barra de navegação não afeta a imagem exibida na página de login.
Incluindo Logotipo na Barra de Navegação
Customize o site incluindo o logotipo da sua organização na barra de navegação. A customização do
logotipo da barra de navegação não afeta a imagem exibida na página de login.
Sobre Esta Tarefa
Incluir um logotipo customizado na barra de navegação associa a organização à identidade da marca. A
customização do logotipo é feita com a atualização do tema da organização. É possível alterar o logotipo
por meio de Configurações da Organização ou editando-se a página da organização.
7
Procedimento
1.
2.
3.
4.
Clique em Administração > Gerenciar Organização.
Clique em Tema.
Clique em Alterar na seção Logotipo e carregue o novo logotipo.
Assegure-se de que o logotipo não fique oculto configurando Exibir Logotipo como Mostrar.
“Projetando a Página da sua Organização” na página 7
descrição.
Atualizando Perfis do Usuário
Inclua campos customizados no perfil do usuário para capturar informações relevantes para sua
organização. Por padrão, um perfil de usuário inclui campos para nome e outras informações de contato.
Procedimento
1. Clique em Administração > Gerenciar Organização.
2. Clique em Customização de Perfil.
3. Clique em Incluir. Insira um nome de campo e selecione a configuração de privacidade.
A configuração de privacidade determina quem pode ver esse campo nos perfis do usuário.
Visível Público: Qualquer um que possa ver o perfil do usuário pode ver esse campo
customizado.
Usuários: Apenas os usuários que possuem uma conta do IBM SmartCloud for Social Business
podem ver esse campo customizado.
Usuários da Mesma Organização: Somente os outros membros da organização do usuário podem
ver esse campo customizado.
Contatos da Rede: Somente membros da organização do usuário e os contatos da rede do usuários
podem ver esse campo customizado.
Resultados
Os campos customizados são incluídos nos perfis de usuários como campos opcionais.
Configurando Informações Pessoais
Visualize e atualize suas configurações pessoais, incluindo nome, nível de acesso, senha e código do
idioma.
Sobre Esta Tarefa
Somente aquelas opções onde você vê Alterar podem ser modificadas.
Procedimento
1. Clique em seu nome na barra de navegação.
2. Clique em Minhas Configurações da Conta.
3. Clique em Alterar para atualizar seu nome, senha, preferência de idioma ou fuso horário.
8
Criando Comunicados da Organização
Transmita mensagens para os usuários contendo informações que deseja que eles conheçam. Os
comunicados são exibidos na Página inicial para todos os usuários da organização. Eles são diferentes
dos comunicados do sistema, que são enviados pelo Suporte para transmitir mensagens a todos os
usuários sobre o site. Por exemplo, o Suporte usa comunicados do sistema como notificações de
manutenção futura.
Sobre Esta Tarefa
Você pode exibir até três comunicados para os usuários a qualquer momento. É possível criar e salvar até
oito comunicados.
Procedimento
2. Expanda a seção com o nome da sua organização e clique em Comunicados.
3. Clique em Incluir Comunicado e preencha os detalhes do comunicado.
v Título: Insira o título do comunicado. É possível usar até 128 caracteres de byte único.
v Texto da Mensagem: Insira o conteúdo do comunicado. É possível usar até 1000 caracteres de byte
único.
v Endereço de URL: Isso é opcional. Insira um endereço da Web a ser exibido no comunicado.
v Descrição da URL: Isso é opcional. Insira uma descrição do endereço da Web no comunicado.
v Expiração: Isso é opcional. Por padrão, os comunicados não expiram. Para configurar uma data de
expiração, selecione Isto expirará em uma data selecionada e insira uma data e hora. A hora e data
são configuradas usando o fuso horário local.
4. Para salvar um comunicado sem transmiti-lo, clique em Salvar. Para salvar um comunicado e
transmiti-lo a todos os usuários, clique em Salvar e ativar.
Resultados
Para ativar um comunicado depois que ele for salvo, clique na seta para baixo referente ao comunicado
apropriado e selecione Ativar. Também é possível editar, desativar ou excluir um comunicado desse
menu.
“Subscrevendo Usuários em Comunicados do Sistema”
Os comunicados do sistema são criados pelo Suporte para transmitir mensagens sobre o servidor. Por
exemplo, notificações de manutenção futura. Isso é diferente dos comunicados que os administradores
podem criar e transmitir aos usuários. Por padrão, os comunicados do sistema são exibidos depois que
um usuário efetua login. Além disso, os administradores podem selecionar para que os comunicados do
sistema sejam encaminhados para contas de e-mail de usuários individuais.
Subscrevendo Usuários em Comunicados do Sistema
Os comunicados do sistema são criados pelo Suporte para transmitir mensagens sobre o servidor. Por
exemplo, notificações de manutenção futura. Isso é diferente dos comunicados que os administradores
podem criar e transmitir aos usuários. Por padrão, os comunicados do sistema são exibidos depois que
um usuário efetua login. Além disso, os administradores podem selecionar para que os comunicados do
sistema sejam encaminhados para contas de e-mail de usuários individuais.
Sobre Esta Tarefa
Ao subscrever usuários para receber comunicados do sistema como emails, os administradores podem
assegurar que os comunicados do sistema sejam vistos sem depender de o usuário efetuar login.
9
Procedimento
1.
2.
3.
4.
Clique em Contas de Usuário.
Clique na seta ao lado do usuário que você deseja subscrever nos comunicados do sistema.
Selecione Subscrever em Comunicados.
O que Fazer Depois
Para parar o envio de emails para um usuário inscrito nos comunicados do sistema, clique em
Administração > Gerenciar Organização > Contas do Usuário, clique na seta ao lado do usuário
apropriado e selecione Cancelar Assinatura dos Comunicados.
“Criando Comunicados da Organização” na página 9
Transmita mensagens para os usuários contendo informações que deseja que eles conheçam. Os
comunicados são exibidos na Página inicial para todos os usuários da organização. Eles são diferentes
dos comunicados do sistema, que são enviados pelo Suporte para transmitir mensagens a todos os
usuários sobre o site. Por exemplo, o Suporte usa comunicados do sistema como notificações de
manutenção futura.
Trabalhando com Aplicativos Internos
Conceda acesso aos aplicativos internos para o IBM SmartCloud for Social Business. Um aplicativo
interno é qualquer aplicativo usado por sua organização que não esteja disponível por padrão. Ao
registrar esses aplicativos no servidor, você os disponibiliza aos usuários de sua organização.
Sobre Esta Tarefa
Para trabalhar com um aplicativo interno, esse aplicativo deve primeiro ser registrado no servidor. Os
usuários acessam o aplicativo registrado no modo normal, mas o aplicativo pode agora interagir com o
servidor. Por exemplo, um usuário pode postar um arquivo no aplicativo que depois pode ser
disponibilizado em sua organização.
O registro do aplicativo é implementado usando o protocolo OAuth com os pares chave e segredo.
OAuth 1.0 e OAuth 2.0 são suportados. O OAuth 2.0 introduz novos recursos, como a capacidade de
customizar por quanto tempo um aplicativo tem acesso ao servidor. Quando o acesso do aplicativo
expira, é solicitado aos usuários que concedam o acesso de aplicativo às suas contas. Com o OAuth 1.0,
um acesso do aplicativo demora algumas horas. Com o OAuth 2.0, é possível selecionar a concessão de
permissão para seu aplicativo interno por até 90 dias. É possível optar por ativar o suporte OAuth 2.0
para seu aplicativo interno quando registrá-lo.
Procedimento
2. Clique em Aplicativos Internos.
3. Clique em Registrar Aplicativo. OAuth 1.0a é ativado, por padrão.
Insira um nome e uma descrição para o aplicativo, quando solicitado. O nome e a descrição de seu
aplicativo podem ser alterados a qualquer momento clicando no menu ao lado do aplicativo e
selecionando Editar Propriedades. O nome do aplicativo não pode exceder 50 caracteres e a
descrição do aplicativo não pode exceder 1000 caracteres.
Selecione Tipo OAuth para ativar OAuth 2.0. Ativar o OAuth 2.0 fornece a opção de selecionar a
duração de acesso e especificar uma URL de retorno de chamada. Duração de Concessão de
Acesso define o quanto demora para que o acesso do aplicativo interno ao servidor expire. A URL
de Retorno de Chamada é usada para enviar informações sigilosas ao seu servidor. O envio dessas
10
informações sobre HTTPS é necessário para evitar a possibilidade de elas serem interceptadas. O
usuário retornará a essa URL depois de aprovar ou negar acesso para o aplicativo.
Durante o registro, serão designados uma chave e um segredo ao seu aplicativo. Os aplicativos
registrados são exibidos nos Aplicativos Internos.
O que Fazer Depois
Depois de registrar o seu aplicativo, pode ser necessário reconfigurar o par chave e segredo. Por exemplo,
reconfigure os valores se suspeitar que estão comprometidos. Para reconfigurar a chave e o segredo,
clique no menu do aplicativo apropriado e selecione Reconfigurar Credenciais. Assegure-se de atualizar
o seu aplicativo com as novas credenciais.
Para visualizar o par chave e segredo do OAuth designado a um aplicativo, clique no menu do aplicativo
apropriado e selecione Mostrar Credenciais.
Para revogar o acesso dos aplicativos ao servidor, clique no menu do aplicativo apropriado e selecione
Excluir.
Abrir Autorização (abre uma nova janela)
Customizando a Identidade de sua Marca
Como fornecedor, é possível customizar as informações exibidas quando os clientes efetuam login em sua
organização. Reformular a marca das telas que os clientes veem identifica o site com sua organização.
É possível customizar as informações que os clientes veem enquanto estão efetuando login em sua
organização, redefinindo sua senha, ou se estiverem visualizando sua Página inicial. Essas mudanças dão
visibilidade à sua marca e também afetam sua própria organização.
É possível customizar as seguintes informações de identificação da marca:
Logotipo do login
Faça upload de uma imagem para usar como o logotipo que aparece nas páginas de login e de
reconfiguração de senha. O logotipo de login é a imagem que um usuário vê ao efetuar login em
uma organização que pertence ao cliente. Usuários que efetuam login na organização também
podem ver essa imagem. Esse logotipo não é exibido na barra de navegação. Fazer upload de
uma nova imagem sobrescreve a imagem atual. Se precisar manter uma cópia da imagem atual,
faça download dela antes de fazer upload de uma nova.
Acesse Administração > Gerenciar Organização > Configurações do Sistema > Tema para
atualizar o logotipo de login.
Informações sobre a organização
Customize as informações que os clientes veem sobre sua organização. O nome da organização
especificado aqui é exibido na página que os clientes usam para efetuar login na organização. Os
detalhes da organização especificados aqui também são exibidos quando são enviados emails aos
clientes. Por exemplo, o email enviado quando um usuário é incluído na organização contém
informações da organização.
Acesse Administração > Gerenciar Organização e clique em Identidade da Marca no nome da
organização para atualizar as informações sobre a organização.
As informações especificadas em Identidade da Marca > Alterar as Informações sobre a
Organização não afetam o nome da organização que aparece na barra de navegação. Para editar
o nome da organização que aparece na barra de navegação e em toda a organização, clique em
Administração > Gerenciar Organização > Configurações de Conta da Organização.
11
Links
Edite os links pertencentes ao cliente que são exibidos em uma organização. Use esses links para
direcionar usuários que efetuam login em uma organização pertencente ao cliente para suas
informações protegidas por direitos autorais. Esses links são exibidos no rodapé da Página
inicial.
organização para atualizar os links da organização.
Informações de suporte
Edite os links que são exibidos em sua organização e em uma organização pertencente ao cliente.
Use esses links para direcionar usuários que efetuam login em uma organização pertencente ao
cliente para suas informações de suporte. A URL de suporte é exibida no menu Ajuda. A URL do
Email de suporte é exibida no rodapé da Página inicial.
organização para atualizar as informações de suporte.
Se um cliente especificar um email de suporte para sua organização em Administração >
Gerenciar Organização > Configurações do Sistema > Segurança, essa URL substituirá a URL
fornecida aqui.
“Projetando a Página da sua Organização” na página 7
descrição.
12
Capítulo 5. Configurando Contas do Usuário
Antes de um usuário possa acessar a organização, uma conta deve ser criada para ele. Somente
administradores podem incluir contas do usuário. Cada conta do usuário tem uma ou mais funções
designadas a ela que determinam o que um usuário pode ver e fazer.
Existem diversas funções que podem ser designadas a uma conta do usuário.
v Um Usuário pode visualizar uma página da organização, incluir arquivos e acessar suas configurações
pessoais. Ele não pode acessar as configurações da organização, modificar nenhuma configuração do
sistema, como opções de segurança, opções de perfis, ou modificar temas ou logotipos da organização.
Somente os usuários podem ter assinaturas e acesso ao conteúdo.
v Um Desenvolvedor de Aplicativos possui acesso suficiente para integrar os aplicativos internos de sua
organização, mas não possui acesso a outras áreas do Administrador. Ele não pode acessar as
configurações da organização, modificar nenhuma configuração do sistema, como opções de segurança,
opções de perfis, ou modificar temas ou logotipos da organização. Conceda a um usuário essa função
quando desejar acessar o Aplicativo Interno para registrar os aplicativos customizados usando o
OAuth. O desenvolvedor de aplicativos não pode subscrever-se em um serviço a menos que também
esteja designado à função de usuário.
v Um Assistente de Administrador tem permissões suficientes para reconfigurar as senhas de login de
todos os usuários. Entretanto, eles não podem reconfigurar as senhas do IBM Notes. Ele também pode
reenviar convites para usuários pendentes. Um assistente de administrador não pode subscrever um
serviço, a menos que ele também esteja designado à função de usuário.
v Um Administrador tem acesso para modificar todas as configurações da organização (por exemplo,
informações de contato e descrição), configurações do sistema (como as opções de segurança), regras
de compartilhamento de arquivos e o tema da organização. Eles podem também incluir ou remover
usuários, gerenciar funções, designar privilégios de administrador ou privilégios de assistente de
administrador aos usuários, ativar aplicativos integrados e gerenciar assinaturas. Os administradores
podem também reconfigurar as senhas de login para todos os usuários e senhas do Notes. Os
administradores não podem assinar um serviço, a menos que também estejam designados para a
função de usuário.
Incluindo Usuários
Para incluir usuários, você deve ter privilégios de administrador.
Antes de Iniciar
Antes de incluir um usuário, saiba quais funções você deseja designar a eles, quais assinaturas você
deseja que eles tenham acesso e o endereço de e-mail deles. As assinaturas são categorizadas como
serviços de Colaboração ou Correio. Os serviços de Colaboração incluem componentes para rede social
como Atividades, Comunidades, Arquivos, Events e Meetings. Os componentes disponíveis para sua
organização dependem das ofertas compradas. Os serviços de Correio incluem o IBM SmartCloud Notes
e o IBM SmartCloud iNotes.
Se desejar incluir muitos usuários de uma só vez, entre em contato com o Responsável pelo Atendimento
ao Cliente para solicitar ativação do servidor de integração. A IBM oferece um serviço de assinatura de
servidor e integração para possibilitar que você faça upload de diversos usuários de uma só vez da sua
organização da empresa local diretamente para o seu diretório da organização do SmartCloud Engage.
Esse serviço de upload inclui usuários na sua conta do IBM SmartCloud for Social Business. Também é
possível usar o serviço do servidor de integração para fazer upload de mudanças quando as informações
sobre os usuários no diretório corporativo mudam. Se você tiver o SmartCloud iNotes, é possível fazer
13
upload dos usuários do seu diretório corporativo para o diretório de contatos do iNotes. Consulte
Solicitando ativação do servidor de integração e Visão geral do servidor de integração para informações
adicionais.
Dependendo dos serviços selecionados durante a criação da conta inicial, pode haver mais de uma
maneira de notificar o usuário de sua nova conta. Para usuários que possuem um serviço de colaboração,
os administradores fornecem um endereço de email que se torna a Identidade da Conta. Esses usuários
recebem um e-mail de convite nesse endereço. Ao configurar uma conta para um usuário do SmartCloud
Notes, os administradores devem fornecer uma senha temporária com a qual o novo usuário efetuará
login. Os administradores devem notificar os novos usuários dessa senha temporária. Ao configurar uma
conta para usuários do SmartCloud iNotes, os administradores têm a opção de criar uma senha de login
temporária ou associar essa conta do usuário a um endereço de email alternativo que seja externo à
organização. Um e-mail de convite pode ser enviado para o endereço de e-mail externo.
Procedimento
Para incluir um usuário, clique em Administração > Gerenciar Organização > Contas do Usuário >
Incluir Conta do Usuário e forneça as informações necessárias para cada etapa.
1. Especifique as configurações básicas do usuário e designe as atribuições em Informações sobre o
Usuário A função Usuário deve ser selecionada para que esse usuário possa ser inscrito em um
serviço. Selecione Assistente do Administrador para fornecer a um usuário a capacidade de
reconfigurar senhas para outros ou de reenviar convites pendentes ou expirados. Selecione
Administrador para conceder a esse usuário privilégios administrativos. Selecione Desenvolvedor de
Aplicativos para usuários que devem registrar aplicativos internos.
2. Use Assinaturas para selecionar a quais serviços um usuário tem acesso, inclua acesso móvel no
email, e aloque qualquer armazenamento adicional para usar para arquivos ou email.
Selecione a assinatura apropriada para designar ao usuário. Também é possível ativar o correio
remoto selecionando a opção apropriada em Complementos.
Se a sua organização comprou armazenamento extra, é possível alocar a quantia de armazenamento
para o usuário que está sendo incluído. A cota de arquivos permite especificar a quantidade total de
espaço em disco que um usuário tem disponível para fazer o upload de arquivos. A cota de correio
permite especificar a quantidade total de espaço em disco que um usuário tem disponível para
armazenamento de emails. O armazenamento extra deve ser especificado em números inteiros, como
1 ou 2. Não use frações ou decimais.
3. Use Complementos para ativar o archiving de email ou os dispositivos móveis.
4. Use Login da Conta para especificar a identidade da conta do usuário. O email especificado aqui
torna-se o ID com o qual o usuário efetuará login. Esse email é conhecido como a identidade da
conta. Ao criar uma conta de usuário para assinaturas de correio, há opções adicionais que os
administradores podem especificar.
v Preferência de login inicial: Para usuários do SmartCloud Notes, os administradores devem criar
uma senha temporária que é usada no login inicial. Para usuários do SmartCloud iNotes, os
administradores podem selecionar para criar uma senha de login inicial ou fornecer um endereço
de email alternativo para o qual enviar o convite.
v Apenas SmartCloud Notes: Os administradores podem especificar o nome distinto que usarão.
Esses campos são opcionais e se estiverem em branco, o SmartCloud Notes tentará defini-los.
Resultados
Depois que um usuário é criado, o status da conta fica pendente até que ele efetue login ou conclua o
registro.
A menos que uma conta tenha sido criada com uma senha temporária, o usuário receberá um email que
contém um link para uma página de registro após a criação da conta. O usuário deve clicar nesse link e
concluir o processo de registro inserindo informações sobre o país, fuso horário e opções de notificação.
14
Também pode ser solicitado que seja criada uma senha. Depois que o registro for submetido, o novo
usuário poderá efetuar login em sua organização. Se a sua organização desativou a verificação de e-mail
do cliente, os novos usuários não receberão os e-mails de convite.
Os administradores podem reenviar os convites para contas pendentes clicando na seta junto a um nome
de usuário e selecionando Reenviar Convite. Clique em Reenviar Todos os Convites Expirados para
reenviar todos os convites expirados.
O que Fazer Depois
Se a sua organização inclui SmartCloud Notes, revise a documentação de administração do SmartCloud
Notes sobre como incluir e fornecer usuários.
Depois que um usuário for incluído, seu convite ficará com o status pendente. Os convites pendentes são
convites que não foram usados para concluir o registro e que não expiraram. Um convite pendente
expirará após aproximadamente 28 dias. Depois que um convite pendente expira, ele não pode ser usado
para registrar e obter acesso à organização. Um administrador ou assistente de administrador deve
reenviar o convite expirado antes de um usuário poder concluir o registro e efetuar login.
É possível verificar o status de um convite a qualquer momento acessando as Contas do Usuário.
15
“Entendimento de Funções” na página 23
Saiba mais sobre as funções disponíveis para contas de usuários. O entendimento das diferentes funções
ajuda o cliente a selecionar as funções corretas para os seus usuários.
Capítulo 6, “Gerenciando Usuários”, na página 19
Os administradores podem excluir, suspender ou editar uma conta do usuário clicando na seta ao lado
do usuário apropriado. Os administradores também podem gerenciar contas de usuários reenviando
convites pendentes ou visualizando relatórios dos usuários.
“Visão Geral do Servidor de Integração” na página 43
O servidor de integração permite integrar as informações de fornecimentode usuário e integração de
grupo a partir de seu ambiente administrativo local. Também permite fazer upload de usuários no
diretório corporativo de sua organização para o diretório de contatos corporativos do SmartCloud iNotes.
“Gerenciando Assinaturas” na página 25
Um administrador pode iniciar avaliações de assinatura gratuitas, comprar novas assinaturas, visualizar o
histórico de assinaturas ou optar por atualizar as assinaturas de avaliação existentes para assinaturas
completas, comprando-as. Pode não haver assinaturas de avaliação disponíveis para sua organização.
“Reenviando Convites” na página 19
Um administrador ou um assistente de administrador pode reenviar e-mails de convites expirados ou
pendentes para todas as contas de usuários pendentes ou para contas individuais. O email de convite
contém um link que um usuário deve seguir para concluir o registro. Após o registro ser concluído, um
usuário pode efetuar login.
“Reconfigurando Senhas e Reenviando Convites” na página 18
Um usuário com a função Assistente de Administrador pode reconfigurar senhas do usuário para o site
ou reenviar convites expirados ou pendentes. Os Assistentes de Administrador não podem reconfigurar
as senhas do IBM Notes.
“Solicitando a Ativação do Servidor de Integração” na página 43
Para começar a usar o servidor de integração, seu administrador deve entrar em contato com um
Responsável pelo Atendimento ao Cliente (CSR) do IBM SmartCloud for Social Business para solicitar a
ativação.
Documentação do produto para o SmartCloud Notes (abre uma nova janela)
Lista de documentações disponíveis do IBM SmartCloud for Social Business. Abre em uma nova janela.
Ativando Aplicativos Integrados de Terceiros
Inclua soluções integradas de nossos parceiros de negócios para aprimorar a produtividade do usuário.
Essas ofertas baseadas em nuvem ajudam sua equipe a operar de maneira mais eficiente.
Procedimento
2. Clique em Aplicativos Integrados de Terceiros para visualizar os aplicativos de terceiros suportados.
3. Clique em Ativar no aplicativo apropriado para torná-lo disponível aos usuários.
Aplicativos integrados são desativados por padrão. Selecionando Ativar, os administradores podem
ativar um aplicativo integrado para uma conta de usuário individual ou para todas as contas de
usuários. Selecionando Ativar para todos os usuários atuais a partir da descrição do aplicativo, o
aplicativo será ativado para a organização e todos os usuários atuais.
Para customizar quanto tempo um aplicativo terá acesso ao IBM SmartCloud for Social Business,
configure a Duração de Concessão de Acesso. Duração de Concessão de Acesso define quanto tempo
16
demora para que o acesso do aplicativo integrado ao IBM SmartCloud for Social Business expire.
Quando o acesso do aplicativo expira, é solicitado aos usuários que concedam o acesso de aplicativo
às suas contas.
4. Disponibilize o aplicativo a um usuário.
Para que um usuário possa acessar um aplicativo integrado, um administrador deve ativar esse
aplicativo na conta de usuário apropriada.
a. Clique em Administração > Gerenciar Organização > Contas do Usuário.
b. Clique na seta ao lado do usuário que precisa de acesso ao aplicativo integrado e selecione Incluir
Aplicativos de Terceiros.
c. Selecione os aplicativos integrados que você deseja disponibilizar ao usuário.
O que Fazer Depois
Toda vez que um aplicativo integrado for ativado para uma conta de usuário, esse usuário receberá um
e-mail de notificação. Pode ser necessário ter uma configuração adicional para cada aplicativo a fim de
que ele se torne disponível. Para obter detalhes, consulte a documentação do aplicativo integrado de
terceiros.
É possível reconfigurar o acesso que os aplicativos integrados possuem ao IBM SmartCloud for Social
Business. Se você usar um aplicativo após a reconfiguração das permissões, será solicitado que autorize o
acesso desse aplicativo a seu conteúdo.
Requisitos de Senha
Novos usuários, cujas contas são criadas com uma senha temporária, estão prontos para criar uma senha
no login inicial. Os usuários cujas senhas são reconfiguradas devem também criar novas senhas no
próximo login. As senhas devem estar em conformidade com os requisitos específicos de comprimento e
caractere.
Todas as senhas do site devem estar em conformidade com estas regras:
v O tamanho mínimo da senha é de oito caracteres.
v Elas devem conter pelo menos um caractere não alfabético e pelo menos quatro caracteres alfabéticos.
v Elas não podem conter três ou mais caracteres repetidos ou o caractere de espaço.
v Elas não podem ser iguais a nenhuma das últimas oito senhas.
v Elas não podem conter seu nome ou endereço de e-mail.
Os usuários podem clicar em Esqueceu a senha? para terem sua senha reconfigurada. Esse link
reconfigura a senha da organização, mas não necessariamente reconfigura a senha de email. Os
administradores e os assistentes de administrador podem reconfigurar as senhas clicando na seta ao lado
de um usuário listado em Contas do Usuário e selecionando Reconfigurar Senha. Os assistentes de
administrador podem reconfigurar a senha de login para um usuário, mas não podem reconfigurar as
senhas do IBM Notes. Os administradores podem reconfigurar as senhas de login e as senhas do IBM
Notes. Usuários que efetuam login clicando em Usar o Login da Minha Organização estão usando uma
identidade federada e só podem reconfigurar suas senhas seguindo o processo da empresa.
Os administradores podem ativar as configurações de segurança para forçar as expirações de senha por
meio de Configurações do Sistema > Segurança. Quando um usuário fizer login com uma senha
expirada, ele será solicitado a reconfigurar essa senha.
Para evitar a reciclagem de uma senha, um usuário pode reconfigurar sua própria senha somente uma
vez em um período de 24 horas. Entretanto, os assistentes de administrador e os administradores podem
reconfigurar uma senha do usuário a qualquer momento.
17
“Configurando a Expiração de Senha” na página 24
Por padrão, as senhas não expiram. Forçar um período de expiração da senha ajuda a garantir que as
senhas sejam alteradas com frequência. Os administradores podem configurar um intervalo de expiração
de senha para todos os usuários.
Reconfigurando Senhas e Reenviando Convites
Um usuário com a função Assistente de Administrador pode reconfigurar senhas do usuário para o site
ou reenviar convites expirados ou pendentes. Os Assistentes de Administrador não podem reconfigurar
as senhas do IBM Notes.
Sobre Esta Tarefa
Um assistente de administrador pode ajudar a gerenciar os usuários em uma organização reenviando
convites para que o administrador não tenha que fazê-lo. O email de convite reenviado contém um link
que um usuário deve seguir para concluir seu registro. Após o registro ser concluído, um usuário pode
efetuar login. Os assistentes de administrador podem também reconfigurar senhas para usuários que não
reconfiguram suas próprias senhas porque o tempo mínimo da senha de 24 horas não expirou.
O reenvio de convites não é suportado para usuários criados somente com a opção de senha. Por
exemplo, os usuários do SmartCloud Notes com contas pendentes não conseguem um email de convite
porque essas contas são criadas com uma senha. Entretanto, os usuários do SmartCloud iNotes criados
com um endereço de email alternativo podem ter convites reenviados porque o convite é enviado ao
endereço especificado como o email alternativo.
Procedimento
v Reconfigure as senhas do usuário.
1. Clique em Administração.
2. Selecione a seta ao lado do usuário cuja senha necessita ser alterada. Também é possível clicar no
nome do usuário.
3. Selecione Reconfigurar Senha. Preencha os prompts para reconfigurar a senha.
4. Notifique o usuário da mudança de senha. O usuário não é notificado automaticamente de que a
senha foi reconfigurada. Assegure-se de comunicar essa mudança ao usuário, junto com a nova
senha, se for necessário.
v Reenvie convites pendentes ou expirados.
1. Clique em Administração para acessar Contas do Usuário.
2. Para reenviar todos os convites expirados, clique em Reenviar Todos os Convites Expirados.
Também é possível reenviar um convite expirado ou pendente para um usuário individual clicando
no seu nome ou clicando na seta ao lado de seu nome.
“Incluindo Usuários” na página 13
18
Capítulo 6. Gerenciando Usuários
do usuário apropriado. Os administradores também podem gerenciar contas de usuários reenviando
convites pendentes ou visualizando relatórios dos usuários.
Reenviando Convites
Um administrador ou um assistente de administrador pode reenviar e-mails de convites expirados ou
pendentes para todas as contas de usuários pendentes ou para contas individuais. O email de convite
contém um link que um usuário deve seguir para concluir o registro. Após o registro ser concluído, um
usuário pode efetuar login.
Sobre Esta Tarefa
Convites pendentes são aqueles que não foram usados para registro e não estão expirados. Um convite
pendente expirará após aproximadamente 28 dias. Depois que um convite pendente expirar, ele não
poderá ser usado para registro na organização até que o administrador ou o assistente do administrador
reenvie o convite expirado.
O reenvio de convites não é suportado para usuários criados somente com a opção de senha. Por
exemplo, os usuários do SmartCloud Notes com contas pendentes não conseguem um email de convite
porque essas contas são criadas com uma senha. Entretanto, os usuários do SmartCloud iNotes criados
com um endereço de email alternativo podem ter convites reenviados porque o convite é enviado ao
endereço especificado como o email alternativo.
Apenas administradores possuem acesso a Administração > Gerenciar Organização.
Procedimento
1. Os administradores clicam em Administração > Gerenciar Organização. Se você for um assistente de
administrador, clique em Administração.
2. Clique em Contas de Usuário.
3. Reenvie o e-mail de convite. É possível incluir conteúdo customizado no e-mail de convite.
v Clique em Reenviar Todos os Convites Expirados para reenviar o email de convite para todas as
contas expiradas.
v Clique na seta ao lado da conta do usuário pendente apropriada e selecione Reenviar Convite para
reenviar o e-mail de convite pendente a uma conta de usuário individual.
19
Editando, Suspendendo e Excluindo Contas do Usuário
do usuário apropriado.
Antes de Iniciar
Se sua organização incluir contas de usuário do SmartCloud Notes, revise a documentação de
administração do SmartCloud Notes sobre como excluir, suspender ou editar um usuário antes de fazer
alterações em uma conta.
Procedimento
3. Clique na seta ao lado da conta do usuário que você deseja editar. Daqui, você pode excluir,
suspender ou editar uma conta do usuário. Ao excluir uma conta do usuário, é possível selecionar a
transferência dos arquivos desse usuário para outra conta inserindo o endereço de email do usuário
que deverá receber os arquivos no campo Designar a.
Nota: Todos os arquivos da conta que você estiver excluindo serão excluídos permanentemente se
você não transferir os arquivos para outra conta inserindo um endereço de email no campo Designar
a.
Resultados
Essas mudanças não entram em vigor enquanto o usuário excluído não efetuar logout.
O que Fazer Depois
Para transferir a propriedade de atividades, associações da comunidade e outros dados de conta para
outra conta:
1. Suspenda a conta da qual a propriedade será transferida para evitar acesso adicional da conta.
2. Decida se a propriedade temporária será necessária. Geralmente ela é cedida ao gerente do
funcionário da conta original.
3. Decida quem receberá permanentemente a propriedade dos tipos de conteúdo a serem transferidos.
Mais de uma pessoa pode herdar o conteúdo.
4. Mude a senha na conta e comunique isso ao proprietário temporário, se aplicável.
5. Remova a suspensão da conta.
6. Transfira a propriedade de arquivos para o funcionário ou funcionários alternativos designados.
7. Efetue login na conta, ou instrua o proprietário temporário a efetuar login na conta com a nova senha.
Navegue para cada comunidade e atividade para a qual o funcionário da conta original é o
proprietário de negócios designado e mude o proprietário de negócios para o funcionário ou
funcionários alternativos.
8. Quando todas as redesignações de propriedade de conteúdo forem concluídas, suspenda a conta
novamente para confirmar que todo o conteúdo está corretamente redesignado.
20
9. Exclua a conta da qual a propriedade foi transferida. Assim que essa conta for excluída, todos os
arquivos, comunidades e atividades de propriedade dessa conta serão excluídos permanentemente.
Reconfigurando Senhas de Login
Um usuário pode reconfigurar sua própria senha apenas uma vez em um período de 24 horas clicando
em Esqueceu a senha?. Um administrador ou assistente de administrador pode reconfigurar senhas para
qualquer usuário e a qualquer momento. Os administradores podem reconfigurar as senhas para
qualquer usuário em qualquer momento. Os Assistentes de Administrador podem reconfigurar as senhas
de login a qualquer momento, mas não podem reconfigurar as senhas do IBM Notes.
Sobre Esta Tarefa
Reconfigure as senhas quando um usuário esquecer sua senha ou quando a senha puder estar
comprometida. Usuários que efetuam login clicando em Usar o Login da Minha Organização estão
usando uma identidade federada e só podem reconfigurar suas senhas seguindo o processo da empresa.
Se os administradores ativarem o recurso de sincronização de senha do SmartCloud Notes, quando os
usuários mudarem suas senhas de login, eles também poderão usar as novas senhas para efetuar login no
cliente do IBM Notes. Para informações sobre esse recurso, consulte a documentação Administrando o
SmartCloud Notes.
Siga estas etapas para reconfigurar a senha de qualquer usuário:
Procedimento
3. Selecione a seta ao lado do usuário cuja senha necessita ser alterada.
4. Selecione Reconfigurar Senha e insira a nova senha. Essa é uma senha temporária que o usuário
insere na próxima vez em que efetuar login. Nesse momento, é solicitado que o usuário crie uma
senha.
Se você estiver reconfigurando uma senha para um usuário com uma assinatura de correio, poderá
reconfigurar também sua senha editando sua conta do usuário. Clique no nome de usuário
apropriado em Contas do Usuário e insira uma nova senha na seção Assinaturas > Correio.
5. Notifique o usuário da mudança de senha. O usuário não é notificado automaticamente de que a
senha foi reconfigurada. Assegure-se de comunicar essa mudança ao usuário, junto com a nova senha,
se for necessário.
O que Fazer Depois
Os administradores podem ativar as configurações de segurança para forçar as expirações de senha por
meio de Configurações do Sistema > Segurança. Quando um usuário fizer login com uma senha
expirada, ele será solicitado a reconfigurar essa senha.
Ocultando Pessoas do Diretório de Organização
Por padrão, os usuários são incluídos no diretório da organização quando suas contas tornam-se ativas.
Os administradores podem optar por impedir que um usuário seja exibido na seção Pessoas da página
para a organização.
Capítulo 6. Gerenciando Usuários
21
Procedimento
1. Clique em Pessoas e selecione sua organização na lista. Essa página também pode ser acessada
clicando em Gerenciar Diretório na página da organização.
2. Selecione os nomes dos usuários a serem ocultados.
3. Clique em Ocultar na Página da Organização.
Resultados
Para exibir um usuário oculto no diretório da organização, selecione esse usuário e clique em Mostrar na
Página da Organização.
Resolução de Problemas de Login
Soluções para problemas comuns encontrados durante o login inicial ou ao reconfigurar uma senha.
Tabela 1. Resolução de Problemas de Login
Problema
O usuário não recebe o e-mail de configuração de registro após a criação da nova
conta em um serviço.
Soluções Possíveis
v Verifique se o endereço de e-mail inserido em Contas do Usuário > Identidade da
Conta está correto.
v Verifique se o e-mail de confirmação não está no filtro de SPAM do seu cliente de
e-mail. Na maioria dos casos, a inclusão de [email protected] na sua lista de
contatos evita a filtragem incorreta de SPAM.
v Entre em contato com o Atendimento ao Cliente em [email protected].
O usuário recebe um erro "Token Inválido" ao tentar confirmar o registro usando o
link no e-mail de confirmação.
v Tente copiar e colar a URL inteira do e-mail de confirmação em um novo
navegador da Web.
v O token é válido por 28 dias, por isso se o usuário não aceitar o convite dentro
desse prazo, você deverá entrar em contato com o Atendimento ao Cliente em
[email protected].
O usuário tenta reconfigurar sua senha na tela de login, mas nunca recebe um e-mail
contendo detalhes adicionais para reconfigurar a senha.
v Verifique se a reconfiguração de senha não está no filtro de SPAM do cliente de
e-mail do usuário.
v Se o e-mail ainda não tiver sido entregue, entre em contato com o Atendimento ao
Cliente em [email protected].
22
Capítulo 7. Configurando a Conta da Organização
Configure a conta da sua organização, incluindo a especificação de configurações de segurança para
senhas, configuração de faixas de endereço IP e gerenciamento de assinaturas.
Uma sessão é válida por até 18 horas. Após 18 horas, os usuários devem efetuar login novamente antes
de acessar a organização. Para evitar perda de dados devido a uma sessão expirada, salve seu trabalho
antes de sair.
Entendimento de Funções
Saiba mais sobre as funções disponíveis para contas de usuários. O entendimento das diferentes funções
ajuda o cliente a selecionar as funções corretas para os seus usuários.
v Um Usuário pode visualizar uma página da organização, incluir arquivos e acessar suas configurações
pessoais. Ele não pode acessar as configurações da organização, modificar nenhuma configuração do
sistema, como opções de segurança, opções de perfis, ou modificar temas ou logotipos da organização.
Somente os usuários podem ter assinaturas e acesso ao conteúdo.
v Um Assistente de Administrador tem permissões suficientes para reconfigurar as senhas de login de
todos os usuários. Entretanto, eles não podem reconfigurar as senhas do IBM Notes. Ele também pode
reenviar convites para usuários pendentes. Um assistente de administrador não pode subscrever um
serviço, a menos que ele também esteja designado à função de usuário.
v Um Desenvolvedor de Aplicativos possui acesso suficiente para integrar os aplicativos internos de sua
organização, mas não possui acesso a outras áreas do Administrador. Ele não pode acessar as
configurações da organização, modificar nenhuma configuração do sistema, como opções de segurança,
opções de perfis, ou modificar temas ou logotipos da organização. Conceda a um usuário essa função
quando desejar acessar o Aplicativo Interno para registrar os aplicativos customizados usando o
OAuth. O desenvolvedor de aplicativos não pode subscrever-se em um serviço a menos que também
esteja designado à função de usuário.
v Um Administrador tem acesso para modificar todas as configurações da organização (por exemplo,
informações de contato e descrição), configurações do sistema (como as opções de segurança), regras
de compartilhamento de arquivos e o tema da organização. Eles podem também incluir ou remover
usuários, gerenciar funções, designar privilégios de administrador ou privilégios de assistente de
administrador aos usuários, ativar aplicativos integrados e gerenciar assinaturas. Os administradores
podem também reconfigurar as senhas de login para todos os usuários e senhas do Notes. Os
administradores não podem assinar um serviço, a menos que também estejam designados para a
função de usuário.
Edite uma conta do usuário para redesignar uma função. Clique em Administração > Gerenciar
Organização > Contas do Usuário e, em seguida, clique no nome de usuário apropriado. Em
FunçãoInformações sobre o Usuário, é possível selecionar funções adicionais para o usuário. É possível
também remover uma função de um usuário ao limpá-la. Se você limpar a função de Usuário, você
estará pronto para transferir os dados deste usuário para um novo usuário. Essa transferência evita a
perda de conteúdo associado a este usuário.
Restringindo o Intervalo de Endereços IP
Para assegurar-se de que os usuários efetuem login usando uma conexão de rede aprovada, os
administradores podem definir um intervalo aprovado de endereços IP.
23
Sobre Esta Tarefa
Ao restringir os endereços IP que possuem acesso à sua organização, você fornece um nível de proteção
contra roubo ou phishing de credenciais do usuário. Se os intervalos de IP estiverem restritos à sua rede,
um invasor precisaria autenticar-se no servidor de dentro de sua rede para acessar qualquer credencial
roubada.
Se a sua empresa usar protocolos SMTP, POP ou iMAP, as restrições não serão aplicadas.
Procedimento
1. Clique em Administração > Gerenciar Organização
2. Clique em Segurança.
3. Clique em Incluir Intervalo na seção Variações de Endereços IP para inserir os endereços IP de início
e fim. Você deve especificar o endereço IP no qual possui login atualmente.
Resultados
A ativação de restrições de endereço IP pode bloquear o acesso de usuário remoto à sua organização. Por
exemplo, os usuários Blackberry devem autenticar-se através de um Blackberry Enterprise Server (BES)
que autentica o dispositivo móvel e o usuário. Como o endereço IP para o usuário autenticado é aquele
do servidor BES, as restrições de endereço IP podem bloquear o acesso, dependendo do intervalo
especificado. Use as ferramentas VPN no dispositivo móvel para rotear o tráfego para sua organização
usando a sua rede
O que Fazer Depois
É possível usar as restrições de endereço IP como um mecanismo de autenticação secundário em
combinação com a autenticação de conexão única SAML.
Configurando a Expiração de Senha
Por padrão, as senhas não expiram. Forçar um período de expiração da senha ajuda a garantir que as
senhas sejam alteradas com frequência. Os administradores podem configurar um intervalo de expiração
de senha para todos os usuários.
Procedimento
1. Clique em Administração > Gerenciar Organização
2. Clique em Segurança.
3. Clique em Editar Configurações na seção Configurações de Senha. Selecione o número de dias antes
da expiração de uma senha, como a senha pode ser reconfigurada e inclua suporte de reconfiguração
de senha para seus usuários.
“Requisitos de Senha” na página 17
Novos usuários, cujas contas são criadas com uma senha temporária, estão prontos para criar uma senha
no login inicial. Os usuários cujas senhas são reconfiguradas devem também criar novas senhas no
próximo login. As senhas devem estar em conformidade com os requisitos específicos de comprimento e
caractere.
Visualizando Contas do Usuário Disponíveis
Para cada assinatura, os administradores podem ver quantas contas de usuário estão disponíveis para
serem designadas.
24
Procedimento
Clique em Administração > Gerenciar Organização > Assinaturas. Cada assinatura lista o número de
contas de usuário total e disponível. É possível expandir cada linha de assinatura para obter mais
informações sobre essa assinatura.
O que Fazer Depois
É possível também visualizar contas de usuário disponíveis indo para Administração > Gerenciar
Organização > Contas do Usuário. As assinaturas disponíveis são listadas nesta página. Para ver o
histórico de pedidos de conta da sua organização, inclusive uma lista de assinaturas adquiridas, clique
em Administração > Gerenciar Organização > Histórico de Pedidos.
“Gerenciando Assinaturas”
Gerenciando Assinaturas
Sobre Esta Tarefa
Use a página Assinaturas para gerenciar suas assinaturas de avaliação e pagas. Incluir uma assinatura de
avaliação é uma boa maneira de avaliar se uma assinatura se ajusta a suas necessidades antes de
comprá-la. Para que um usuário possa acessar uma assinatura de avaliação, um administrador deve
torná-la disponível ao usuário ativando-a na Conta do Usuário apropriada.
A página Assinaturas também contém informações sobre quaisquer assinaturas de avaliação existentes e
assinaturas pagas de propriedade da organização. É possível revisar a data de compra da assinatura, a
data de expiração e descobrir quantas contas de usuário ainda estão disponíveis. Clicando em Histórico
para uma assinatura, é possível ver um histórico de eventos e suas datas para cada assinatura. Por
exemplo, é possível ver a data de renovação da assinatura e detalhes sobre a renovação, ou se uma
assinatura tem algum complemento.
Procedimento
Siga estas etapas para gerenciar as assinaturas:
1. Clique em Administração > Gerenciar Organização > Assinaturas.
2. Para visualizar detalhes da assinatura, expanda a linha apropriada. Clique em Fazer Upgrade da
Assinatura para ir de uma assinatura de avaliação existente para uma assinatura paga. O upgrade de
uma assinatura conduz você pelo processo de e-commerce para comprá-la. Somente contas para teste
podem ser atualizadas. Novas avaliações podem ser iniciadas clicando em Incluir Avaliação.
3. Para comprar uma assinatura para a qual você não possui atualmente uma avaliação, clique em
Comprar Assinatura. Para comprar uma oferta de assinatura a qualquer momento, clique em
Administração > Comprar a partir do IBM SmartCloud.
O que Fazer Depois
Depois de incluir uma assinatura em sua conta, você deve ativá-la para cada usuário para torná-la
disponível a ele. Para ativar assinaturas para um usuário, acesse Administração > Gerenciar Organização
Capítulo 7. Configurando a Conta da Organização
25
> Contas do Usuário e selecione o usuário a ser editado. Dentro da página de conta do usuário, selecione
a guia Assinaturas e selecione a assinatura apropriada.
Para ver o histórico de pedidos de conta da sua organização, inclusive uma lista de assinaturas
adquiridas, clique em Administração > Gerenciar Organização > Histórico de Pedidos.
“Visualizando Contas do Usuário Disponíveis” na página 24
Para cada assinatura, os administradores podem ver quantas contas de usuário estão disponíveis para
serem designadas.
Permitindo que os Usuários Sejam Listados no Diretório da
Organização
Por padrão, os membros de sua organização não são listados no Diretório da Organização. Isso significa
que esses usuários não são visíveis para membros de outras organizações. Os administradores podem ter
todos os usuários listados publicamente no diretório, ter apenas usuários específicos listados
publicamente ou permitir que cada usuário decida se deseja ser listado publicamente.
Sobre Esta Tarefa
Se você não estiver visível no diretório, não será listado quando procurado pelos usuários fora de sua
organização. Se você estiver listado no diretório, outros usuários externos à sua organização poderão
localizar e incluir você na rede deles.
Procedimento
2. Clique em Configurações do Sistema > Diretório da Organização
3. Clique em Alterar na seção Política de Organização para Procura de Diretório.
4. Selecione a configuração de privacidade apropriada.
v Opção do Usuário: Permite que os usuários decidam se serão listados no diretório. A listagem
torna-os pesquisáveis para usuários fora da organização.
v Todos Particulares: Essa opção é selecionada por padrão. Todos Particulares evita que os usuários
sejam localizados por usuários externos à organização.
v Todos Particulares com Exceções: Controla quais usuários são listados no diretório.
Apenas os usuários que você listar em Exceções serão visíveis aos usuários externos da sua
organização. Qualquer usuário não listado em Exceções será considerado um usuário particular e
não será listado no diretório.
Quando você seleciona essa opção, uma lista de exceções é criada. Essa lista contém os nomes dos
usuários que você seleciona para tornar público ao incluir um nome em Exceções. Esse campo não
representa a lista atual de exceções. Ele representa apenas os usuários que estão sendo incluídos na
lista de exceções já existente. Para ver a lista de usuários que já são exceção, clique em Visualizar
todas as exceções.
Para sobrescrever os usuários existentes já listados como uma exceção, selecione Permitir que
apenas os usuários listados atualmente em Exceções sejam exibidos no diretório. Os usuários
selecionados anteriormente como exceções são removidos do diretório.. Em seguida, inclua em
Exceções quaisquer usuários que você pretenda tornar público . Essa lista substitui qualquer lista
de exceções atual.
26
Capítulo 8. Administrando o IBM SmartCloud iNotes
Depois que o Responsável pelo Atendimento ao Cliente tiver criado sua conta ou você iniciar uma
avaliação gratuita, insira e verifique o nome de domínio de sua organização e comece a definir
configurações, gerenciar email e gerenciar contatos.
Protocolos Suportados
O IBM SmartCloud iNotes suporta os protocolos padrão de Internet mais predominantes para
recuperação de email.
Protocolos
A lista a seguir identifica os protocolos suportados:
v POP3
v IMAP
v SMTP Autenticado
v IMAP IDLE
Uma vez registrado o domínio, o servidor de nomes de domínio da interface de serviço IMAP, POP e
SMTP não poderá ser alterado.
Portas
Dependendo do ambiente, você poderá precisar abrir as seguintes portas de rede no firewall. Por
exemplo, se você usar apenas correio da Web, precisará da porta HTTP aberta, mas as outras portas não
precisam ser abertas. O s indica a porta para o tráfego seguro (SSL).
v HTTP: 80
v HTTPs: 443
v
v
v
v
v
POP3: 110
POP3s: 995 (-pop.mail.lotuslive.com)
IMAP4: 143
IMAPs: 993 (-imap.mail.lotuslive.com)
SMTP: 587
v SMTPs: 465 (-smtp.mail.lotuslive.com)
Para conexões IMAP, POP e SMTP, abra o seguinte endereço IP no firewall: 8.12.152.0/24
Ao configurar, o cliente precisa possuir e configurar o registro MX. O registro MX é uma das muitas
entradas DNS que uma organização poderá configurar. Para definir o registro MX, o cliente deve ter
controle técnico das configurações de DNS para o domínio.
27
Configurando o Acesso IMAP e POP (abre uma nova janela)
Segurança da Conta
As contas do IBM SmartCloud iNotes são autenticadas com um endereço de email e uma senha. Todos os
usuários têm os mesmos privilégios de e-mail padrão. As contas só podem ser criadas por um
administrador.
Se você tiver uma conta que esteja ativada com diversas assinaturas e desejar acessar seus emails antes
de visualizar outros componentes, efetue login em mail.lotuslive.com (abre uma nova janela). Depois de
efetuar login, será possível acessar seu correio e outros componentes designados à sua conta.
O SmartCloud iNotes está em conformidade com as seguintes certificações de segurança:
v ITCS104 Segurança de TI para sistemas gerenciados IBM
v ITCS329 Segurança para serviços de negócios terceirizados
v FIN151 Controles e Auditabilidade de Sistemas de Aplicativos
v CIO122 Gerenciamento de registros mundiais da IBM
v CP130 Política de privacidade de dados da IBM com plano de privacidade documentado
v LEG116 Classificação e controle de informações da IBM
v LEG117 Manipulação de informações pessoais coletadas on-line
v USRP US Procedimentos de Regulamentações de Exportação
Os sistemas de infraestrutura e servidor IBM usam políticas, padrões e processos de segurança internos
da IBM para assegurar que os sistemas sejam configurados e gerenciados de maneira segura e
compatível. Os padrões de segurança são consistentes com as melhores práticas de segurança e se
alinham com a série ISO 27000.
Os serviços são hospedados nos datacenters de propriedade da IBM com uma infraestrutura física
projetada para proteger seus sistemas e dados. Todas as conexões do cliente são criptografadas usando
SSL. A segurança é fornecida para atender todos os requisitos estabelecidos por lei e regulamentares
internacionais, federais, estaduais e locais.
Roteando E-mail de Saída
Os administradores podem rotear e-mail de saída por meio de um servidor SMTP externo.
Sobre Esta Tarefa
Seguem algumas razões pelas quais retransmitir correio de saída por meio de um servidor SMTP externo:
v Integração com soluções de arquivamento de conformidade
v Triagem de mensagens através de um sistema de proteção contra perda de dados
v Requisitos complexos de roteamento de correio corporativo
Use o roteamento SMTP para controlar o tráfego de saída definindo um nome de servidor para o IBM
SmartCloud iNotes. Esse nome de servidor permite ao SmartCloud iNotes rotear email de saída que se
origina com os usuários da organização. O roteamento pode ser feito no nível do domínio ou do usuário.
Para implementar essa opção, você deve fornecer as seguintes informações:
v O nome do host ou o endereço IP do servidor SMTP de saída
v Verificação se o usuário está configurado corretamente. Por exemplo, certifique-se de que as mensagens
de email enviadas do agente de transferência de correio (MTA) de saída do SmartCloud iNotes sejam
aceitas por esse host para retransmissão de correio.
28
Procedimento
Depois que você tiver essa informação, será possível configurar o gateway de correio de saída para todos
os usuários ou para usuários individuais:
2. Clique em iNotes.
3. Clique em Gateway de Correio de Saída para configurar ou modificar um gateway para todos os
usuários. Insira o endereço do gateway de correio em Gateway de Saída. Para excluir o gateway para
todos os usuários, exclua o endereço do Gateway de Saída.
4. Para configurar um gateway ou atualizar o endereço do gateway existente para usuários individuais,
utilize o seguinte procedimento:
a. Clique em Gerenciador de Contas de Correio.
b. Selecione um ID de Usuário na lista.
c. Clique no ícone Gateway de Saída na coluna Ação.
d. Insira o endereço do servidor gateway de saída.
e. Clique em Salvar.
5. Para excluir o gateway para um usuário individual, utilize o seguinte procedimento:
a. Clique em Gerenciador de Contas de Correio.
b. Selecione um ID de Usuário na lista.
c. Clique no ícone Gateway de Saída na coluna Ação.
d. Exclua o endereço do servidor gateway de saída.
e. Clique em Salvar.
Incluindo Domínios em uma Lista de Desbloqueio
Os usuários podem bloquear determinados endereços de e-mail ou domínios. Usando uma lista de
desbloqueio, os administradores podem designar hosts de toda a organização a partir dos quais as
mensagens são sempre enviadas pelo servidor.
Procedimento
1.
2.
3.
4.
Clique em iNotes
Clique em Lista de Desbloqueio.
Insira o nome de domínio ou o endereço IP para o host incluído na lista de desbloqueio.
Nota: Para assegurar que os endereços IP sejam reconhecidos pelo servidor, consulte a lista de
parâmetros a seguir.
v Assegure-se de que o endereço IP seja publicamente roteável. Endereços IP reservados e de rede
privada não são reconhecidos pelo servidor.
v Insira um endereço IP no seguinte formato: x.x.x.x em que x é um valor entre 0 e 255.
Incluindo uma Assinatura de E-mail
Os administradores podem incluir uma assinatura padrão ou tagline no e-mail de saída de todos os
usuários em sua organização. Os usuários não podem impedir que a tagline seja incluída nos e-mails que
eles enviam.
29
Sobre Esta Tarefa
Uma maneira de promover a identidade corporativa é com assinaturas de e-mail. As assinaturas de
e-mail fornecem à sua organização a oportunidade de padronizar a aparência de todos os e-mails de
saída.
Você deve ter uma versão HTML e uma de texto simples da sua tagline pronta para ser carregada. O
suporte gráfico é limitado à inclusão de um link externo na sua tagline HTML.
Procedimento
Para incluir assinatura corporativa:
2. Clique em iNotes > Gerenciador de Tagline.
3. Carregue a mensagem da tagline, selecione o idioma apropriado e clique em Publicar.
As versões de texto simples e HTML da tagline devem ser fornecidas, e os arquivos devem ser
codificados como UTF-8. A tagline será exibida no final de cada mensagem e não pode ser modificada
nem excluída pelos usuários.
Para cada idioma, só é possível fornecer um arquivo de tagline. Se você fornecer diversos idiomas, o
idioma que corresponde ao código do idioma do usuário será incluído nesse e-mail do usuário. Se
não houver taglines que correspondam ao idioma de um usuário, o inglês será incluído por padrão.
Se não houver taglines que correspondam ao idioma de um usuário e não houver tagline em inglês
disponível, então nenhuma tagline será incluída nos e-mails desse usuário.
Enviando E-mails de Comunicados
Mensagens transmitidas a seus usuários. Comunicados são e-mails enviados pelos administradores a
todos os usuários na sua organização.
Sobre Esta Tarefa
Use os comunicados para notificar os usuários sobre informações importantes de sua organização.
Procedimento
1.
2.
3.
4.
Clique
Clique
Clique
Clique
em
em
em
em
Administração > Gerenciar Organização.
iNotes.
Comunicados na seção Correio.
Novo Comunicado para criar um comunicado por e-mail.
Os campos obrigatórios são De, Assunto, Mensagem e Entrega. O Assunto não pode exceder 100
caracteres e a Mensagem não pode exceder 8000 caracteres. Se você quiser que os usuários estejam
aptos a responder ao seu comunicado, insira um endereço de e-mail válido em Resposta. Para enviar
uma visualização do seu comunicado a um usuário específico, selecione Entrega > Enviar uma
visualização do Comunicado a e insira o endereço de e-mail apropriado. Certifique-se de que Entrega
> Enviar a todos os usuários na empresa seja selecionado para enviar o comunicado a todos os
usuários.
Os anúncios não são enviados a qualquer endereço de e-mail alternativo especificado nas contas do
usuário. Além disso, os usuários que são externos da sua organização não podem receber e-mails de
comunicado.
O que Fazer Depois
Os novos comunicados levam alguns minutos para serem processados antes do envio. Você pode verificar
o status do comunicado clicando no próprio e visualizando seu Estado. Após o envio dos comunicados,
30
eles são listados como Concluído no painel iNotes > Comunicados.
Gerenciando Domínios da Organização
Inclua domínios registrados em sua organização ou remova-os dela. Inclua um domínio quando sua
organização precisar de suporte para um novo domínio. Remova um domínio se ele foi inserido
incorretamente ou se você não precisar mais dele registrado em sua organização.
Procedimento
v Para incluir um domínio, clique em Administração > Gerenciar Organização > iNotes > Gerenciador
de Domínio e clique em Incluir Domínio.
v Para remover um domínio:
1. Remova todos os usuários do domínio a ser excluído. Para remover usuários, acesse Administração
> Gerenciar Organização > Contas do Usuário e edite os usuários apropriados.
2. Clique em Administração > Gerenciar Organização > iNotes > Gerenciador de Domínio e clique
em Excluir Domínio.
Antes de excluir esse domínio, você deve remover todos os usuários do domínio.
Gerenciando Contas do Usuário do IBM SmartCloud iNotes
Os administradores podem alterar endereços de e-mail, criar alias para contas, configurar endereços de
e-mail de encaminhamento, destruir permanentemente o correio excluído e permitir que os usuários
acessem a agenda corporativa.
Alterando Endereços de Email do Usuário
Assim que um endereço de email IBM SmartCloud iNotes é criado, ele não pode ser alterado. Se
necessário, pode ser criado um alias para a conta do usuário.
Sobre Esta Tarefa
Para criar um alias para uma conta do usuário, consulte o “Criando um Alias para uma Conta” na
página 32. Criar um alias para um usuário permite que o usuário envie e receba emails usando o
endereço de alias exatamente como ele fazia usando o endereço original.
Localizando Usuários
Localize um usuário do iNotes e modifique suas configurações de conta.
Procedimento
2. Clique em iNotes > Gerenciador de Contas de Correio.
3. Insira o endereço de e-mail do usuário do iNotes e clique em Procurar.
Após a conclusão da procura, os usuários correspondentes aos critérios são listados. Para cada usuário
é possível selecionar para configurar o gateway de saída, esvazia a lixeira do usuário, encaminhar
seus e-mails para uma conta diferente, criar um alias para a conta do usuário e fornecer a esse
usuário a capacidade de criar, editar ou excluir eventos de calendário ativando o calendário
corporativo.
31
“Roteando E-mail de Saída” na página 28
Os administradores podem rotear e-mail de saída por meio de um servidor SMTP externo.
“Esvaziando uma Lixeira”
Quando os usuários excluem o email, ele é movido para uma pasta da lixeira e ainda pode ser
recuperado. Os administradores podem remover permanentemente essas mensagens e recuperar o espaço
de cota do disco para os usuários.
“Criando um Alias para uma Conta”
Os administradores podem criar alias para as contas dos usuários para ajudá-los a gerenciar os e-mails
que eles recebem.
“Encaminhando E-mail de uma Conta” na página 33
Os administradores podem encaminhar e-mail do usuário automaticamente para contas de e-mail
alternativo. Entretanto, você não pode encaminhar e-mail enviado para uma conta de e-mail de alias.
“Permitindo que os Usuários Gerenciem o Calendário Corporativo” na página 33
Há três tipos diferentes de calendários: pessoal, secundário e corporativo. Os administradores podem
permitir que os calendários corporativos proporcionem aos usuários a capacidade de criar os eventos
nesse calendário. Até que um calendário corporativo seja ativado para um usuário, esse usuário não
poderá criar, editar ou excluir os eventos no calendário corporativo. O calendário corporativo é usado
para compartilhar eventos da organização com todos os usuários da organização.
Esvaziando uma Lixeira
Quando os usuários excluem o email, ele é movido para uma pasta da lixeira e ainda pode ser
recuperado. Os administradores podem remover permanentemente essas mensagens e recuperar o espaço
de cota do disco para os usuários.
Procedimento
Para esvaziar a lixeira do usuário:
3. Localize o usuário na lista. Também é possível inserir o endereço de e-mail do usuário do iNotes e
clicar em Procurar. Uma vez localizado o usuário, você poderá optar por destruir seu correio
excluído, clicando no ícone da lixeira.
Criando um Alias para uma Conta
Os administradores podem criar alias para as contas dos usuários para ajudá-los a gerenciar os e-mails
que eles recebem.
Sobre Esta Tarefa
Alias de e-mail são úteis para diversos propósitos. Os usuários podem utilizar alias para receber e-mail
de forma anônima, gerenciar e-mails de diferentes projetos ou alterar virtualmente seus endereços.
Procedimento
Para criar um alias de e-mail para um usuário:
clicar em Procurar.
4. Clique em Incluir conta de alias para o nome de usuário selecionado. Todos os alias existentes são
listados aqui.
32
5. Insira o nome para a conta de alias e clique em Incluir para incluir na lista de alias do usuário.
O que Fazer Depois
Você pode excluir um alias clicando no ícone Ação para o alias apropriado.
Encaminhando E-mail de uma Conta
Os administradores podem encaminhar e-mail do usuário automaticamente para contas de e-mail
alternativo. Entretanto, você não pode encaminhar e-mail enviado para uma conta de e-mail de alias.
Sobre Esta Tarefa
Os endereços de encaminhamento ajudam os usuários a gerenciar seus e-mails. Por exemplo, os usuários
podem encaminhar e-mail para outro endereço ao trabalhar remotamente.
Procedimento
Para configurar um endereço de encaminhamento para um usuário:
clicar em Procurar.
4. Clique em Correio de encaminhamento para o usuário selecionado.
5. Insira o endereço de e-mail para o qual você deseja encaminhar o correio. Para enviar email para o
endereço de encaminhamento e o endereço de login, marque a caixa de opção depois do campo do
endereço de encaminhamento. Para enviar o correio somente para o endereço de encaminhamento,
essa caixa de seleção deve ser desmarcada.
Permitindo que os Usuários Gerenciem o Calendário Corporativo
Há três tipos diferentes de calendários: pessoal, secundário e corporativo. Os administradores podem
permitir que os calendários corporativos proporcionem aos usuários a capacidade de criar os eventos
nesse calendário. Até que um calendário corporativo seja ativado para um usuário, esse usuário não
poderá criar, editar ou excluir os eventos no calendário corporativo. O calendário corporativo é usado
para compartilhar eventos da organização com todos os usuários da organização.
Sobre Esta Tarefa
O uso do calendário corporativo mantém os usuários atualizados com os eventos e as reuniões da
organização. Deve ser concedido por um administrador a cada usuário o acesso à agenda corporativa
para que eles possam acessar a agenda.
Procedimento
3. Você pode ativar ou desativar o compartilhamento da agenda corporativa para cada usuário listado,
clicando no ícone Agenda Corporativa. É possível alternar a agenda reconfigurando como desativada
ao clicar no ícone novamente.
Nota: Depois de ativar o calendário corporativo para uma conta, ele será exibido no próximo login
do usuário.
33
Gerenciando Contatos do IBM SmartCloud iNotes
Inclua os contatos na lista de endereços Gerenciador do Diretório Corporativo, exporte a sua lista de
endereços e crie as listas de distribuição.
Incluindo Contatos do Catálogo de Endereços
Preencha a lista de endereços do Gerenciador de Diretório Corporativo importando informações de
contato de um arquivo ou tendo as informações de contato incluídas automaticamente durante a criação
de uma conta do usuário. Os usuários então podem acessar o catálogo de endereços para localizar outros
usuários.
Sobre Esta Tarefa
O número máximo de contatos que podem ser importados no diretório depende do tipo de conta que
você tem. Uma conta de serviço pago pode ter até 500.000 contatos. Uma conta de avaliação poderá ter
até 100.000 contatos se estiver usando seu próprio domínio. Uma conta de avaliação que usa o domínio
de avaliação padrão pode ter até 500 contatos na lista de endereços.
É possível ter apenas uma lista de endereços.
Procedimento
1. Para incluir automaticamente informações de contato durante a criação de uma conta do usuário:
a. Clique em Administração > Gerenciar Organização.
b. Clique em iNotes > Gerenciador do Diretório Corporativo.
c. Clique em Preencher automaticamente o Diretório Corporativo (recomendado).
Ao incluir uma conta do IBM SmartCloud iNotes, ele gera automaticamente uma entrada de
Diretório Corporativo. Se o usuário existir no Diretório Corporativo, será criada uma entrada
duplicada. Por exemplo, se você criar uma conta para um usuário a partir de uma conta do
Microsoft Exchange que já esteja na organização, será criada uma entrada duplicada. As entradas
duplicadas resultam da inclusão de usuários que contêm uma conta existente no momento que
você inclui suas informações externas. Edite o Diretório Corporativo atualizado para remover
entradas duplicadas.
Se a sua organização possui diversos domínios, será possível especificar se os usuários podem
visualizar as informações de contato em outros domínios selecionando a opção apropriada em
Diversos Domínios.
2. Para importar o arquivo de contatos:
a. Clique em Administração > Gerenciar Organização.
b. Clique em iNotes > Gerenciador do Diretório Corporativo.
c. Clique em Gerenciar manualmente o Diretório Corporativo.
d. Clique em Procurar e selecione o arquivo a ser importado. Atualmente, os arquivos csv, ldif, txt,
vcf e tab são suportados. O arquivo importado deve ser codificado como UTF-8. Esse arquivo
importado substitui o catálogo de endereços atual. Para incluir entradas adicionais, primeiro
exporte o catálogo de endereços e depois inclua qualquer nova entrada.
O que Fazer Depois
Para excluir entradas duplicadas no Diretório Corporativo atualizado, é possível usar um dos seguintes
métodos:
v Se você estiver usando uma planilha, deverá exportar o Diretório Corporativo para uma planilha,
editá-la para remover entradas duplicadas e, em seguida, recarregá-la.
v Se você estiver usando o servidor de integração, será possível excluir entradas duplicadas individuais.
34
“Criando Listas de Distribuição para Grupos”
Os administradores podem criar listas de distribuição de e-mail para vários grupos.
Exportando a Lista de Endereços do IBM SmartCloud iNotes
Os administradores podem editar ou fazer backup da lista de contatos da organização exportando a lista
de endereços Gerenciador de Diretório Corporativo.
Procedimento
Para exportar o arquivo de contatos:
2. Clique em iNotes > Gerenciador do Diretório Corporativo.
3. Selecione o formato de arquivo da lista suspensa na seção Exportar.
Resultados
Ao editar este arquivo, certifique-se de que ele esteja aberto com a codificação UTF-8. Por padrão, o nome
do arquivo exportado é addressbook e a extensão é .csv,ldif ou .txt dependendo do formato
selecionado. O arquivo exportado pode ser aberto para edição ou salvamento como uma lista de contatos
de backup.
Criando Listas de Distribuição para Grupos
Os administradores podem criar listas de distribuição de e-mail para vários grupos.
Sobre Esta Tarefa
Use listas de distribuição para definir grupos para diferentes projetos, departamentos ou interesses. Tanto
usuários que pertencem à organização como usuários externos podem ser incluídos se eles tiverem um
endereço de email válido. Você pode criar a lista inserindo endereços de contato separados por vírgula ou
importando um arquivo de endereços separados por vírgula.
Cada lista de distribuição pode ter no máximo 200 membros. Os membros da lista de distribuição podem
incluir indivíduos ou outras listas de distribuição.
O nome de uma lista de distribuição é formatado da mesma maneira que um endereço de email. Por
exemplo, nome_da_lista@seu_domínio. Todos os caracteres ASCII são suportados. O nome_da_lista não pode
ter mais de 64 caracteres. O domínio não pode ter mais de 128 caracteres.
Procedimento
Para criar uma lista de distribuição:
2. Clique em iNotes > Lista de Distribuição.
3. Clique em Incluir Lista de Distribuição e insira um nome no campo Nome da lista:.
4. Clique em Criar Nova Lista. A lista de distribuição é mostrada, com o número de membros que ela
contém.
5. Adicione os endereços a serem incluídos na lista de distribuição. Para incluir contatos na lista de
distribuição, insira os endereços de e-mail separados por vírgula ou importe uma lista de contatos
(.csv).
35
Resultados
A lista de distribuição é exibida no diretório da organização e pode ser usada por todos os assinantes do
IBM SmartCloud iNotes na organização.
O que Fazer Depois
Por padrão uma lista de distribuição é ativada para todos os usuários da organização. As listas de
distribuição podem ser desativadas limpando a caixa de seleção Ativar Lista apropriada. Desativar listas
de distribuição minimiza o risco de enviar e-mails de spam.
Os usuários não são notificados quando uma lista de distribuição é ativada ou desativada. Se uma lista
de distribuição for desativada, ela não será preenchida automaticamente à medida que um usuário digitar
nela. Se um usuário enviar um email para uma lista de distribuição desativada, o email será devolvido
para a caixa de entrada do remetente.
“Incluindo Contatos do Catálogo de Endereços” na página 34
Preencha a lista de endereços do Gerenciador de Diretório Corporativo importando informações de
contato de um arquivo ou tendo as informações de contato incluídas automaticamente durante a criação
de uma conta do usuário. Os usuários então podem acessar o catálogo de endereços para localizar outros
usuários.
Restringindo a Visibilidade de Domínio
Em uma organização do IBM SmartCloud iNotes que contém diversos domínios, é possível evitar que
usuários de domínios diferentes vejam uns aos outros.
Sobre Esta Tarefa
Se a sua organização tiver diversos domínios, é possível evitar que os usuários vejam as informações de
contato de alguém em um domínio que seja diferente do seu. Isso pode ser útil se a sua organização tiver
diversos domínios e cada domínio tiver um conjunto diferente de usuários. Por padrão, os usuários em
um domínio podem ver as informações de contato dos usuários de outros domínios.
Procedimento
2. Clique em iNotes > Gerenciador do Diretório Corporativo.
3. Selecione a opção apropriada na seção Diversos Domínios.
36
Capítulo 9. Gerenciamento de Identidade Federada
A identidade federada permite que os usuários que efetuarem logon no sistema de sua empresa usem os
serviços baseados em nuvem sem terem que efetuar logon novamente.
Gerenciamento de Identidade Federada
O gerenciamento de identidade federada é manipulado por um serviço de conexão única (SSO) que está
disponível para todos os serviços baseados em nuvem no SmartCloud for Social Business. Se você ativar
o gerenciamento de identidade federada, os usuários que efetuarem logon em seu sistema poderão usar
os serviços baseados em nuvem sem terem que efetuar logon novamente.
Os produtos SmartCloud for Social Business dependem do SAML para fornecer os serviços SSO. Nesta
implementação, sua organização é o provedor de identidade e SmartCloud for Social Business é o
provedor de serviços. É possível usar SAML 1.1 ou SAML 2.0.
Visão Geral do Processo Usando SAML
Como o provedor de identidade, sua organização autentica os usuários. A autenticação pode ser por um
login com um nome de usuário e senha, ou por algum outro método. Quando um usuário obtém acesso à
sua intranet e tenta usar um dos produtos SmartCloud for Social Business, uma asserção SAML é enviada
de sua organização para o terminal SAML no SmartCloud for Social Business. A asserção SAML identifica
seguramente o usuário. O sistema SmartCloud for Social Business usa a asserção SAML para decidir se o
usuário pode acessar os serviços baseados em nuvem.
Para uma descrição mais detalhada do processo como ele é implementado no SmartCloud for Social
Business, consulte os tópicos Modelos de Fluxo de Gerenciamento de Identidade Federada e Tipos de
Gerenciamento de Identidade Federada.
Ativando o Gerenciamento de Identidade Federada
Ao ativar o gerenciamento de identidade federada, você registra sua organização como um provedor de
identidade confiável com o SmartCloud for Social Business. Antes de registrar, você deve implementar e
testar um sistema de gerenciamento de identidade federada usa use SAML. Enquanto está
implementando seu sistema, você deve fazer algumas opções e preparar vários artefatos. Por exemplo,
você deve escolher a versão do SAML a ser usada, escolher o tipo de federação e gerar um par de chaves
pública/privada. Consulte o tópico Ativando o Gerenciamento de Identidade Federada para obter uma lista
dessas atividades.
37
“Modelos de Fluxo de Gerenciamento de Identidade Federada”
Existem dois modelos de fluxo no gerenciamento de identidade federada. Um é o modelo identity
provider initiated (IdP-initiated) e o outro é o modelo service provider initiated (SP-initiated).
“Tipos de Gerenciamento de Identidade Federada” na página 39
No SmartCloud for Social Business, quatro tipos de gerenciamento de identidade federada estão
disponíveis: Não Federado, Federado, Modificado e Parcial. Por padrão, todos os usuários em sua
organização são designados ao tipo Não Federado a menos que você ative um dos outros tipos.
“Preparando o Gerenciamento de Identidade Federada” na página 40
A dificuldade de deixar seu sistema pronto para o gerenciamento de identidade federada depende do
estado de seu sistema e de seu conhecimento e experiência com SAML, SSO, LDAP e tecnologias
relacionadas.
“Ativando o Gerenciamento de Identidade Federada” na página 40
Quando o seu sistema estiver pronto para ser testado com o sistema SmartCloud for Social Business,
entre em contato com um responsável pelo atendimento ao cliente da IBM.
Modelos de Fluxo de Gerenciamento de Identidade Federada
Normalmente, o modelo de fluxo SP-initiated não está disponível no SAML 1.1 porque o SAML 1.1 não
suporta o Perfil de Descoberta de Provedor de Identidade. Entretanto, o SmartCloud for Social Business
usa uma versão híbrida de SP-initiated que permite o SAML 1.1 e o SAML 2.0. Como resultado, o Perfil
de Descoberta de Provedor de Identidade não é requerido pelo SmartCloud for Social Business e não é
implementado.
O SmartCloud for Social Business implementa o perfil de Navegador/POST que é usado no SAML 1.1 e é
compatível com o perfil SSO do Navegador da Web no SAML 2.0. Outros perfis não são suportados no
momento.
A estrutura de tópicos a seguir descreve os dois fluxos:
IdP-initiated
1. O usuário tem acesso à sua intranet por meio do mecanismo de autenticação de sua
organização.
2. O usuário navega para uma página da web em sua intranet que contém um link para um
produto SmartCloud for Social Business, por exemplo, Engage ou Connections.
3. O usuário clica no link.
4. O processo SSO é iniciado. Uma asserção SAML é enviada ao terminal do SmartCloud for
Social Business via HTTP POST. Se o usuário tiver uma conta válida, o acesso será concedido.
5. O usuário interage com o SmartCloud for Social Business.
Híbrido de SP-initiated
1. O usuário navega para a página de login do SmartCloud for Social Business.
2. O usuário clica em Usar Login de Minha Organização.
3. O usuário insere o endereço de email que está associado à conta do usuário.
4. O SmartCloud for Social Business consulta o endereço de email e, em seguida, redireciona o
usuário para o mecanismo de autenticação de sua organização.
5. O fluxo continua a partir da Etapa 4 do modelo IdP-initiated.
38
Tipos de Gerenciamento de Identidade Federada
Escolhendo o Tipo de Federação a Ser Usado
Não Federada
O login para SmartCloud for Social Business é independente, e separado, do procedimento de
login de sua organização. Os usuários devem efetuar logon no SmartCloud for Social Business
para usar os serviços baseados em nuvem.
O tipo Não Federado é o tipo padrão e é o tipo mais simples e fácil de configurar porque não
requer ação de sua parte.
Federado
Os usuários devem autenticar com sua organização antes de poderem acessar os serviços
baseados em nuvem. Os usuários não tem um nome de usuário e senha no SmartCloud for Social
Business. Se eles acessarem a página de login do SmartCloud for Social Business, deverão clicar
em Usar Login de Minha Organização. O tipo Federado se aplica a todos os usuários em sua
organização.
O tipo Federado é conveniente para seus usuários que normalmente trabalham a partir do
escritório. Eles podem efetuar logon em seu sistema e usar o SmartCloud for Social Business sem
precisar de uma combinação de nome de usuário/senha separada. Entretanto, se qualquer um de
seus usuários trabalhar a partir de casa ou durante uma viagem, seus servidores de diretório
deverão ser acessíveis a partir da Internet. Além disso, como seus usuários não têm um login
separado para o SmartCloud for Social Business, serviços como bate-papo e POP/IMAP não estão
disponíveis.
Se você escolher o tipo Federado, deverá implementar o modelo de fluxo SP-initiated.
Modificado
Os usuários têm a opção de autenticar com sua organização antes de acessarem os serviços
baseados em nuvem ou usando seu nome de usuário e senha do SmartCloud for Social Business
para efetuarem logon no SmartCloud for Social Business. O tipo Modificado se aplica a todos os
usuários em sua organização.
O tipo Modificado permite que os usuários acessem o SmartCloud for Social Business a partir da
Internet, mas não é necessário tornar seus servidores de diretório acessíveis a partir da Internet.
Seus usuários podem usar os serviços de conexão única quando estão no escritório e o login do
SmartCloud for Social Business quando estão fora do escritório.
Parcial
Cada usuário em sua organização é designado a um dos tipos listados anteriormente: Não
Federado, Federado ou Modificado. Se você não especificar um tipo para um usuário específico, o
usuário será designado ao tipo Não Federado.
Use o tipo Parcial se você tiver um grupo de usuários que normalmente trabalha no escritório e
um outro grupo de usuários que normalmente trabalha a partir de casa ou que viajam
frequentemente. Por exemplo, os trabalhadores do escritório podem ser designados ao tipo
Federado e a equipe de vendas em viagem pode ser designada ao tipo Modificado.
Também é possível usar o tipo Parcial para agrupar usuários pelos serviços que estão disponíveis
a eles. Os usuários com o tipo Federado não têm acesso ao bate-papo ou POP/IMAP, mas os
usuários do tipo Modificado têm acesso ao bate-papo e POP/IMAP.
39
Se você escolher o tipo Parcial, deverá implementar o modelo de fluxo SP-initiated para suportar
usuários com o tipo Federado.
Alterando o Tipo de Federação
Depois que um dos tipos de federação é implementado, é possível alterar para um dos outros tipos
entrando em contato com seu responsável pelo atendimento ao cliente. O responsável pelo atendimento
ao cliente o avisará sobre o processo. Se você estiver usando o tipo Parcial, será possível alterar usuários
individuais de um tipo para outro sem a necessidade de entrar em contato com seu responsável pelo
atendimento ao cliente.
Preparando o Gerenciamento de Identidade Federada
relacionadas.
Antes de entrar em contato com o responsável pelo atendimento ao cliente da IBM para ativar o
gerenciamento de identidade federada, revise a seguinte lista de verificação:
v Escolha a versão do SAML que você deseja usar. É possível usar SAML 1.1 ou SAML 2.0.
v Escolha o tipo de federação que você deseja usar: Federado, Modificado ou Parcial. Consulte o tópico
Tipos de Gerenciamento de Identidade Federada para obter informações adicionais.
v Revise o modelo de fluxo IdP-initiated e o modelo de fluxo híbrido SP-initiated suportados pelo
SmartCloud for Social Business. Consulte o tópico Modelos de Fluxo de Gerenciamento de Identidade
Federada para obter informações adicionais.
v Implemente o SAML em seu servidor da web. É possível usar o Tivoli Federated Identity Manager,
OpenSAML, Active Directory Federation ou algum outro gerenciador de identidade federada.
v Recupere ou crie o par de chaves privada/pública que será usado em assinaturas digitais.
v Integre seu servidor de diretório com seu serviço SAML. A administração será mais fácil se todos os
seus usuários estiverem no mesmo servidor de diretório.
v Implemente e teste o perfil Navegador SAML/POST no SAML 1.1 ou SAML 2.0.
v Crie um provedor de serviços simulado e conduza um teste de conexão única IdP-initiated para
certificar-se de que tudo esteja funcionando corretamente.
v Crie um arquivo de metadados do SAML para transmitir seus metadados do provedor de identidade
para o responsável pelo atendimento ao cliente da IBM. Se você estiver usando o SAML 1.1, terá a
opção de transmitir a maioria das informações por email ou por algum outro meio que você negociar
com o responsável pelo atendimento ao cliente da IBM. Entretanto, nesse caso, você deverá transmitir a
chave pública dentro de um keystore Java™.
“Modelos de Fluxo de Gerenciamento de Identidade Federada” na página 38
Ativando o Gerenciamento de Identidade Federada
Quando o seu sistema estiver pronto para ser testado com o sistema SmartCloud for Social Business,
entre em contato com um responsável pelo atendimento ao cliente da IBM.
40
Antes de Iniciar
Antes de iniciar o processo de ativação, revise a lista a seguir:
1. Implemente e teste um sistema de gerenciamento de identidade federada que use SAML. Certifique-se
de que seu sistema esteja configurado para enviar o endereço de email do usuário como o assunto em
uma asserção SAML.
2. Teste seu sistema para certificar-se de que ele esteja configurado para o tipo e modelo de fluxo
escolhidos. Consulte os tópicos Tipos de Gerenciamento de Identidade Federada e Modelos de Fluxo de
Gerenciamento de Identidade Federada para obter informações adicionais.
3. Conclua a lista de verificação no tópico Preparando o Gerenciamento de Identidade Federada
Procedimento
Para ativar o gerenciamento de identidade federada:
Envie um email para [email protected]. No email, solicite para ter o gerenciamento de identidade
federada ativado para sua organização. Um responsável pelo atendimento ao cliente da IBM entrará em
contato com você com instruções e fornecerá detalhes do processo.
“Gerenciamento de Identidade Federada” na página 37
O gerenciamento de identidade federada é manipulado por um serviço de conexão única (SSO) que está
disponível para todos os serviços baseados em nuvem no SmartCloud for Social Business. Se você ativar
o gerenciamento de identidade federada, os usuários que efetuarem logon em seu sistema poderão usar
os serviços baseados em nuvem sem terem que efetuar logon novamente.
“Modelos de Fluxo de Gerenciamento de Identidade Federada” na página 38
“Preparando o Gerenciamento de Identidade Federada” na página 40
relacionadas.
41
42
Capítulo 10. Servidor de integração
Integre as informações de fornecimento de usuário e de integração de diretório do iNotes de seu
ambiente administrativo local para o gerenciamento baseado em nuvem.
Visão Geral do Servidor de Integração
O servidor de integração suporta o uso de um ambiente híbrido – um que use uma combinação de
gerenciamento administrativo local e gerenciamento de serviços e assinaturas baseado em nuvem. O
servidor de integração processa periodicamente os arquivos de dados criados e faz upload usando um
mecanismo de transferência de arquivos seguro para incluir, modificar e remover as informações de
fornecimento de usuário e integração de grupo. Isso permite continuar usando seus sistemas de
gerenciamento locais e fazer upload de informações de usuários e grupos periodicamente.
A integração do conteúdo inicial e alterado do seu ambiente administrativo local é facilitada por meio da
assinatura de sua organização ao serviço de servidor de integração e pelos arquivos de mudança
devidamente nomeados e formatados que você periodicamente cria e faz upload.
“Gerenciamento de Identidade e Fornecimento de Usuário” na página 44
Usando o servidor de integração, é possível fazer upload e integrar informações sobre identidade e
fornecimento de usuário a partir de seu sistema local existente quantas vezes forem necessárias.
“Integração do diretório” na página 64
Usando o servidor de integração, é possível fazer upload e integrar alguns ou todos os usuários e grupos
em seu diretório corporativo ao diretório de contatos corporativos do IBM SmartCloud iNotes quantas
vezes forem necessárias.
“Processando Arquivos de Mudanças” na página 70
O servidor de integração é usado para fazer upload de informações de seu sistema local, usando um site
FTP designado, com base nas operações especificadas nos arquivos de mudanças.
Solicitando a Ativação do Servidor de Integração
ativação.
Sobre Esta Tarefa
Prepare-se para fornecer as informações da conta.
Procedimento
1. Envie um email para [email protected] com Integration server enablement request - Nome
do Seu Cliente na linha de assunto.
2. Quando o Atendimento ao Cliente entrar em contato com você em resposta à sua solicitação de
ativação, prepare-se para fornecer as seguintes informações:
v Nome do cliente – Especifique o nome da conta, por exemplo, Acme. Esse valor deve corresponder
ao Nome da empresa (ou organização) de sua organização.
43
v ID do cliente – Especifique o identificador numérico de sua conta. Esse valor deve corresponder ao
ID da empresa (ou organização) de sua organização.
v Usuário do servidor de integração – Especifique um nome de usuário ou identidade de conta para
o qual uma conta FTP será criada para fazer upload dos arquivos de mudanças do servidor de
integração e fazer o download dos arquivos de resultados por meio do site FTP.
– Essa é a identidade da conta do usuário para o qual será criada uma conta FTP para fazer
upload dos arquivos de mudanças e fazer o download de seus arquivos de relatório, log e
rastreio associados.
Nota: Também é possível especificar uma identidade de conta diferente para a qual será criada
uma conta FTP adicional para fazer o download de arquivos de diários de aplicativo e de
autorização.
– O nome do usuário ou a identidade de conta especificado já deve existir no IBM SmartCloud for
Social Business e não deve exigir uma função de Administrador.
– É possível especificar um ou mais administradores e opcionalmente criar um nome de usuário
ou identidade de conta especificamente para a tarefa requerida, por exemplo
[email protected] para funções do servidor de integração e [email protected]
para funções de registro em diário.
v Administrador do Cliente – Especifique o nome do usuário do administrador único ou a identidade
da conta para executar as ações do arquivo de mudança no IBM SmartCloud for Social Business
para sua organização. Esse valor deve corresponder ao Administrador no Cliente ou sua identidade
de organização.
– Essa identidade é usada para executar solicitações para operações codificadas nos arquivos de
mudanças.
– O nome especificado também pode ser especificado como um usuário do site de integração e
migração.
– Essa identidade é usada apenas quando o servidor de integração processa um arquivo de
mudanças transferido por upload.
Você será notificado quando a ativação estiver concluída e for possível iniciar o uso do servidor de
integração.
Nota: Como o servidor de integração se baseia no IBM Tivoli Directory Integrator (TDI), o
Atendimento ao Cliente pode fornecer um certificado SSL para permitir que sua organização faça
upload com segurança dos arquivos de mudanças e faça o download dos arquivos de resultados
associados por meio do servidor FTP.
“Transferência de Arquivos FTP de Arquivos de Mudanças e Arquivos de Resultados” na página 71
Seus arquivos de mudanças são transferidos por upload para o servidor de integração por meio do site
de integração e migração, usando o protocolo FTP seguro. Esse mesmo mecanismo de transferência FTP
também é usado ao fazer download dos arquivos de resultados associados.
Gerenciamento de Identidade e Fornecimento de Usuário
44
Os componentes que participam do ambiente do servidor de integração são mostrados a seguir.
Componentes adicionais que são gerenciados na nuvem são omitidos dessa lista.
v Sistema do gerenciamento de identidade do cliente
O sistema de gerenciamento de identidade do cliente contém informações sobre identidades do usuário
individuais e dados de fornecimento relacionados e é mantido localmente por você em um sistema
administrativo local.
v Arquivo de mudanças de fornecimento de usuário
Um arquivo de mudança de fornecimento de usuário é um arquivo de texto em formato CSV (valores
separados por vírgula) criado por cliente. Ele contém informações sobre identidade do usuário e lista
as operações a serem executadas para essa identidade. As operações típicas abrangem incluir, excluir e
suspender contas do usuário e ativar assinaturas do usuário. O conteúdo e o nome do arquivo devem
aderir às especificações requeridas.
Você faz upload dos arquivos de mudanças no servidor de integração usando FTP seguro. Mudanças
subsequentes em identidade e fornecimento de usuário em seu sistema de gerenciamento de identidade
local podem ser gravadas periodicamente em novos arquivos de mudanças em uma base
automatizada, por meio da ativação de tarefa ou por meio de um agente customizado, usando as
convenções de nomenclatura e de conteúdo do arquivo requeridas.
Quando o servidor de integração processa um arquivo de mudanças, ele gera um arquivo de relatório
associado.
Para obter informações adicionais sobre os arquivos de mudanças de fornecimento, consulte “Criando
Arquivos de Mudanças de Fornecimento de Usuário” na página 46.
v Site de FTP
Um mecanismo de transferência FTP permite fazer upload de arquivos de mudanças no servidor de
integração (por meio do site de integração e migração baseado em nuvem) sobre um canal
criptografado por SSL autenticado. Também permite fazer o download dos arquivos de relatório e de
rastreio associados.
Nota: É possível designar um ou mais usuários que tenham permissão para fazer upload e download
dos arquivos. Uma pasta particular é dedicada à sua conta. Apenas usuários designados podem acessar
essa pasta.
v Site de integração e migração
O site de integração e migração funciona com o servidor de integração e o site FTP durante o upload
dos arquivos de mudança e o download de seus arquivos de relatório e de rastreio associados.
v Servidor de integração
O servidor de integração lê cada arquivo de mudanças transferido por upload do site FTP e envia as
operações de mudanças codificadas para a conta de sua organização.
v Business Support System
O Business Support System (BSS) é o componente central usado para definir e gerenciar a conta de sua
organização.
45
“Criando Arquivos de Mudanças de Fornecimento de Usuário”
Um arquivo de mudança de fornecimento de usuário é um arquivo de texto em formato CSV criado pelo
cliente que contém informações de fornecimento de usuário de seu próprio sistema de gerenciamento
local. Depois de ter sido permitido usar o servidor de integração, você usa esses arquivos de texto para
fazer upload das informações de fornecimento de usuário.
“Arquivos de Relatório do Servidor de Integração” na página 73
O servidor de integração gera um arquivo de relatório para cada lote de arquivos de mudanças
processados para sua organização.
Criando Arquivos de Mudanças de Fornecimento de Usuário
Dentro do ambiente do servidor de integração ativado, quando você inclui um novo usuário ou altera a
configuração de um usuário existente, é possível manualmente, ou automaticamente usando um agente
customizado, criar um arquivo de mudanças de fornecimento de usuário para capturar essas mudanças.
Esse arquivo de texto é usado para fazer upload das informações de fornecimento de usuário.
Os formatos de nome e de conteúdo do arquivo de fornecimento necessários são descritos aqui.
Para exemplos, consulte “Exemplos: Arquivos de Mudanças de Fornecimento de Usuário” na página 52.
Dentro de seus arquivos de mudanças de fornecimento, é possível fornecer usuários como assinaturas de
lugar de colaboração e correio únicas ou como parte de uma assinatura em pacote configurável. Para
obter detalhes, consulte Especificando uma assinatura em pacote configurável.
Também é possível especificar assinaturas de acessório, incluindo IBM Lotus Traveler, Documentos da
IBM, acesso ao BlackBerry Enterprise Server, Serviços Hospedados do BlackBerry e Feed de Dados de
Retenção de Arquivamento. Para obter detalhes, consulte Especificando uma assinatura de acessório.
Convenção de Nomenclatura do Arquivo de Mudanças de Fornecimento
Os arquivos de fornecimento devem ser nomeados corretamente para serem reconhecidos e processados.
Use a convenção de nomenclatura a seguir ao criar um arquivo de mudança de fornecimento do usuário:
customerId_sourceId_prv_seqnum.csv
Tabela 2. Convenção de Nomenclatura do Arquivo de Mudanças de Fornecimento
Tipo de entrada de nome
do arquivo
Descrição da entrada de nome do arquivo
customerId
Especifica o identificador numérico interno designado ao cliente.
Seu ID de cliente está localizado na seção Conta da Empresa: Configurações da interface com o usuário de Administração. Use o valor
designado à sua conta de cliente específica para o valor de customerId.
sourceId
Especifica o nome opcional da origem autorizada da(s) mudança(s).
A parte sourceId do nome do arquivo de mudanças poderá ficar em branco se houver apenas uma origem de informações de identidade na
organização. Por exemplo, use um sourceId quando dados de origem forem obtidos de um Diretório IBM Domino e um outro quando os dados
de origem forem obtidos de um Active Directory.
tipo
46
O tipo do arquivo de fornecimento do usuário é PRV.
Tabela 2. Convenção de Nomenclatura do Arquivo de Mudanças de Fornecimento (continuação)
Tipo de entrada de nome
do arquivo
seqNum
Especifica o número de sequência usado para ordenar o processamento de arquivos; o valor deve ser um valor de número inteiro entre 0 e
9223372036854775807. O valor não deve ser menor que aquele do último arquivo processado.
Se o último número de sequência foi 9223372036854775807 e tiver sido processado, com êxito ou com uma falha, o próximo arquivo de
provisionamento pode ter um número de sequência de 1 ou acima. Isso permite que você reconfigure o último número de sequência
armazenado no servidor.
O tempo da época UNIX é o formato recomendado. Use o registro de data e hora do UNIX para a parte seqNum do nome do arquivo. Consulte
os detalhes do http://www.epochconverter.com (abre uma nova janela).
Os números de sequência são relativos aos valores customerId e sourceId. Isso permite a independência de máquina e região.
ext
Especifica a extensão do arquivo que indica o tipo de codificação de dados; as opções são as seguintes:
v .ldif - codificação LDIF; deve ser especificada para arquivos de mudança de integração
v .csv - codificação de valores separados por vírgula; deve ser especificada para arquivos de mudanças de fornecimento de usuário
Os nomes dos arquivos de mudanças de fornecimento de exemplo são os seguintes:
v 30020506_HRDatabase_PRV_1260226223.CSV
v 30020506_PRV_1260226223.csv
Em ambos os exemplos, o nome da organização é representado pela sequência de caracteres 30020506, os
arquivos são arquivos de mudanças de fornecimento de usuário, o número de sequência é 1260226223 e o
arquivo é designado como um cujo conteúdo é separado por vírgula. O primeiro exemplo usa o ID de
origem de autorização opcional.
Nota: Ainda que você não possa reconfigurar a numeração sequencial em seus arquivos de mudança de
fornecimento, você pode obter um efeito similar usando um valor sourceId diferente no nome do arquivo.
Por exemplo, se o último arquivo de mudança enviado foi 11223344_source1_PRV_99999999.csv, é
possível enviar subsequentemente um arquivo com o nome 11223344_source2_PRV_11111111.csv.
Nota: Como os valores sourceId e seqNum são controlados por organização, a sincronização de data e hora
não é necessária.
Operações do Arquivo de Mudanças de Fornecimento
É possível codificar várias operações em um arquivo de mudanças de fornecimento de usuário.
Nota: Essa tabela lista os tipos de operação; as entradas de campo e descrições são fornecidas na próxima
tabela.
Nota: Se o usuário estiver em um estado HELD, o servidor de integração rejeitará seu conteúdo de
arquivo de fornecimento e incluirá uma mensagem de erro em seu arquivo de relatório associado.
Nota: A especificação de endereço de email não faz distinção entre maiúsculas e minúsculas; todos os
endereços e email são normalizados para minúscula.
Nota: Usando sua página de conta da organização, é possível especificar opcionalmente que os termos de
uso sejam aceitos automaticamente para todos os usuários.
Tabela 3. Tipos de Operação do Arquivo de Mudanças de Fornecimento
Operação de fornecimento
Descrição
Add
Cria um novo registro de assinante.
Uma operação Add envia um convite por e-mail para o assinante que solicita para configurar sua própria senha, aceitar os termos e condições e
acessar os serviços para os quais ele foi autorizado. O assinante receberá uma conta de login e um perfil autogerenciável. Uma senha
descartável pode ser fornecida, que o assinante deve alterar após o primeiro uso.
Nota: Os usuários não federados e os federados modificados devem concluir o registro usando o processo de convite por e-mail, mesmo se sua
conta tiver sido criada usando um domínio pertencente ao cliente. Os usuários federados são processados automaticamente e não recebem o
convite por e-mail.
Update
Atualiza as informações de pessoa de um assinante, como seu endereço de email ou modelo de correio.
Suspend
Desativa a capacidade de um assinante de efetuar login e usar serviços; isso não remove o usuário nem revoga assinaturas designadas a ele.
47
Tabela 3. Tipos de Operação do Arquivo de Mudanças de Fornecimento (continuação)
Operação de fornecimento
Descrição
Resume
Permite que um assinante suspenso efetue login e use serviços.
Remove
Remove um assinante e revoga todas as suas autorizações. Também exclui todo o conteúdo de colaboração relativo à assinatura de colaboração
atual do usuário ou, opcionalmente, o redesigna a outro assinante.
Nota: A redesignação do conteúdo de correio não é suportada. Se o usuário sendo removido tiver uma assinatura de correio, todo o conteúdo
associado a essa assinatura de correio será excluído.
AssignSeat
Designa um lugar de assinatura ao assinante, aprovisionando todas as autorizações conforme definido na assinatura.
Um lugar de assinatura autoriza o assinante a usar todos os recursos de uma oferta específica.
Um assinante é permitido ter não mais que sua assinatura de correio e uma assinatura de colaboração.
ChangeSeat
Altera o lugar de assinatura de colaboração atual do usuário para um lugar de assinatura de colaboração diferente.
Especifica o novo subscriptionId de colaboração e altera a assinatura existente para a nova assinatura.
Nota: As assinaturas atual e de destino devem ser compatíveis. Entre em contato com o suporte ao cliente para obter uma lista de assinaturas
compatíveis.
Use as palavras-chave DELETECOLLAB e DELETEMAIL ao alterar um usuário existente de uma assinatura em pacote configurável para uma
assinatura de correio ou de colaboração de único lugar.
RevokeSeat
Revoga um lugar de assinante existente, removendo todas as autorizações associadas à assinatura.
Nota: Em vez disso, especifique um valor de subscriptionId particular, especifique COLLAB, MAIL, BUNDLE, BLACKBERRY_HOSTED,
BLACKBERRY_HOSTED_MDS, TRAVELER, BES_ACCESS, IBM_DOCS ou RETENTION no campo subscriptionId para identificar o lugar para revogação.
Nota: Consulte o campo AssignTo na tabela a seguir para excluir opcionalmente todo o conteúdo de colaboração relativo a uma assinatura ou
redesignar a um outra. Para obter uma assinatura de lugar de colaboração, o conteúdo de Arquivos e Atividades podem ser redesignados,
todos os outros dados do usuário são excluídos. O conteúdo do correio não pode ser redesignado.
Rename
Altera o EmailAddress que identifica exclusivamente o usuário e que ele usa para efetuar login.
Essa operação está disponível aos usuários que têm uma assinatura de colaboração ou email.
Para renomear um usuário que não tem uma assinatura híbrida do SmartCloud Notes, basta mudar o endereço de email para esse usuário
usando a operação Renomear.
Enquanto a operação Renomear está disponível para um usuário que tem uma assinatura híbrida do SmartCloud Notes, o seguinte processo em
etapas sequenciais deve ser executado para esse usuário:
1. O administrador de domínio local do cliente muda o endereço de email do usuário em seu diretório Domino.
2. O diretório Domino se sincroniza com o SmartCloud Notes, que atualiza o endereço de emal do usuário no SmartCloud Notes.
3. O administrador do IBM SmartCloud for Social Business pode então especificar a operação Renomear em um arquivo de mudança de
fornecimento usando os procedimentos do servidor de integração normais (ou executar uma renomeação para o usuário individual
diretamente na interface com o usuário de administração do IBM SmartCloud for Social Business).
Nota: As operações devem primeiro ser executadas no diretório Domino local do cliente (Dica: Mantenha o antigo endereço de email
referenciado no campo shortname do registro de pessoa) e depois sincronizado no SmartCloud Notes antes de fazer mudanças no IBM
SmartCloud for Social Business para garantir a continuidade no roteamento do email de notificação. Se o endereço de email de um usuário for
mudado usando a operação Renomear do servidor de integração (ou diretamente na interface com o usuário de administração do IBM
SmartCloud for Social Business) antes de ser mudado no SmartCloud Notes, o email de notificação não será entregue ao novo endereço de
email, pois não será considerado válido no SmartCloud Notes.
Nota: A operação Renomear ocorre imediatamente para usuários federados e federados modificados. Entretanto, ela falhará para um usuário
federado se o novo endereço de e-mail contiver um domínio que o cliente não possui.
ResendInvitation
Envia um e-mail de convite para permitir que um usuário ative uma assinatura para a qual ele teve um lugar designado. Isso geralmente é
usado quando o convite original não foi entregue ou foi perdido ou excluído.
Essa operação também pode ser usada em conjunto com uma operação Add ou AssignSeat que especifica SUPPRESS_ALL no campo
SupressInvitation. Isso permite que um usuário seja pré-aprovisionado (sem o envio de um convite) e convidado a ativar sua assinatura
posteriormente.
ChangeStorage
Especifica a quantia de armazenamento extra a ser designada para uma assinatura de base do usuário.
O campo SubscriptionId especifica a colaboração de base, o correio ou a assinatura em pacote configurável ao qual o armazenamento extra
está associado. Use os campos collabExtraStorage ou mailExtraStorage para especificar a quantia de armazenamento extra a ser designada.
Uma assinatura de armazenamento extra com espaço suficiente para preencher a quantia solicitada é requerida.
Campos de Operação do Arquivo de Mudanças de Fornecimento
A primeira linha do arquivo de mudanças de fornecimento contém as informações do cabeçalho
necessárias; as linhas subsequentes contêm os valores dos campos conforme descrito na tabela a seguir.
Ao codificar o conteúdo do arquivo de mudanças, inclua dados do campo específicos do usuário para as
operações de fornecimento necessárias. Cada linha deve terminar com o feed de linha ou retorno de linha
apropriado para assegurar que os términos de linha sejam processados corretamente durante a
transferência FTP. Consulte “Exemplos: Arquivos de Mudanças de Fornecimento de Usuário” na página
52 para obter detalhes.
48
Tabela 4. Nomes e Descrições dos Campos de Operação do Arquivo de Fornecimento
Nome do campo
Descrição do valor do campo
Necessário ou opcional por operação
EmailAddress
Especifica o endereço de email a ser usado quando o usuário
efetua login.
Esse campo é requerido por todas as operações.
Action
Especifica a operação a ser processada; consulte a tabela
anterior para nomes e descrições das operações.
Esse campo é requerido por todas as operações.
SubscriptionId
Especifica a assinatura que o usuário está autorizado a usar.
Esse campo é requerido pelas operações
AssignSeat e ChangeSeat e opcional para as
operações Add, AddStorage e RevokeSeat.
O limite de caractere é 254.
RevokeSeat é a única operação que possibilita que você
especifique a palavra-chave COLLAB, MAIL, BUNDLE,
BLACKBERRY_HOSTED, BLACKBERRY_HOSTED_MDS, TRAVELER,
BES_ACCESS, IBM_DOCS, ou RETENTION para referenciar uma
assinatura de colaboração, email, pacote configurável ou
acessório que já esteja designado ao usuário.
ChangeSeat é a única operação que considera as palavras-chave
de assinatura DELETECOLLAB e DELETEMAIL (usadas ao mudar de
um pacote configurável para uma assinatura única).
SubscriptionId2
Especifica um segundo identificador interno para a assinatura
que o usuário está autorizado a usar em uma operação Add.
Esse campo é opcional para as operações Add e
ChangeSeat.
Uma entrada Password ou AltEmailAddress é
necessária ao alterar de um lugar que não é um
lugar do SmartCloud Notes or IBM SmartCloud
iNotes para um que seja.
GivenName
Especifica o nome do usuário.
FamilyName
Especifica o sobrenome do usuário.
Language
Especifica o idioma preferencial do usuário.
Esse campo é obrigatório para a operação Add e
opcional para a operação Update.
Esse campo é obrigatório para a operação Add e
opcional para a operação Update.
Update.
Nota: Se nenhum idioma for especificado, o
idioma de contato da empresa será usado. Um
administrador especifica o idioma de contato da
empresa em sua página Configurações da Minha
Conta usando as opções Localização e Idioma.
TimeZone
Especifica o fuso horário do usuário. Consulte Valores de Fuso
Horário para Arquivos de Mudanças para obter os valores legais.
Update.
Password
Quando uma identificação de conta está no processo de ser
estabelecida, esse valor de senha descartável é usado. Quando
o usuário efetua login pela primeira vez, ele é solicitado a
configurar uma nova senha. Esse valor arquivado de senha
deve estar em conformidade com os padrões de senha.
Esse campo é opcional para a operação Add.
Nota: Para uma operação Incluir, esse campo é
necessário para assinaturas de email
independentemente do tipo de federação do
usuário.
AltEmailAddress
Essa configuração tem significado único para cada uma das
seguintes operações de fornecimento:
v Incluir – Se especificada, IBM SmartCloud for Social Business
envia um convite por email para esse endereço para concluir
o estabelecimento da identidade de uma conta. O usuário
segue o link fornecido para estabelecer sua senha de conta.
Isso também especifica o endereço usado para enviar
notificação se a conta de um usuário tiver sido atualizada.
v AssignSeat – Especifica o endereço usado pelo IBM
SmartCloud for Social Business para enviar notificação se a
conta de um usuário tiver sido atualizada.
Nota: Para uma operação Incluir, esse campo é
necessário para assinaturas de email
independentemente do tipo de federação do
usuário.
Esse campo é necessário para operações
AssignSeat (for IBM SmartCloud Notes e
assinaturas de email do IBM SmartCloud iNotes)
e Renomear.
v Renomear – Especifica no novo endereço de email.
49
Tabela 4. Nomes e Descrições dos Campos de Operação do Arquivo de Fornecimento (continuação)
Nome do campo
NotesTemplate
Especifica o modelo de correio do IBM SmartCloud Notes a ser
designado a um assinante de correio do SmartCloud Notes em
um ambiente híbrido ou somente de serviço. Esse campo é
aplicável apenas a operações que referenciam assinaturas de
correio do SmartCloud Notes. O nome especificado deve
corresponder exatamente ao nome do modelo desejado, por
exemplo, StdR85Mail.
Nota: Se diversos modelos de correio estiverem disponíveis
para o usuário do SmartCloud Notes sendo provisionado, use
o seguinte procedimento para determinar o nome do modelo a
ser designação à operação:
Esse campo é opcional para as operações Add,
AssignSeat e Update.
1. Navegue para o diálogo Modelos de Correio no
administrador do SmartCloud Notes.
2. Selecione Modelos de Correio Customizados ou Modelos
de Correio Padrão.
3. Localize a linha que corresponde ao nome, local e versão do
usuário sendo provisionado.
4. Especifique o nome do modelo de correio desejado no
arquivo de mudanças de fornecimento.
Onde houver mais de uma versão do nome do modelo de
correio especificado disponível para o código de idioma do
assinante, por exemplo, StdR85Mail versões 8.5.2 e 8.5.3, a
versão mais recente é usado por padrão. Também é possível
especificar um código de idioma e valor de versão para usar
em combinação com o nome do modelo usando um formato
"name,version,locale".
Além disso, para modelos do Notes suportados, um arquivo de
formulários de extensão fornece uma experiência customizada
para usuários da web doSmartCloud Notes. Aplique arquivos
de formulário de extensão para usuários atuais ou para novos
usuários à medida que os fornecer usando a opção
extension_forms_file (formato
"name,version,locale,extension_forms_file"). Um arquivo de
formulários de extensão deve ser aprovado e transferido por
upload para o serviço antes que você possa aplicá-lo. Para
informações adicionais, consulte Usando arquivos de formulários
de extensão para customizar aparência do web client na
documentação Administrando o SmartCloud Notes.
Para exemplos de como especificar esses valores opcionais,
consulte Exemplos: Arquivos de mudanças de fornecimento de
usuário.
NotesDN
Especifica o Nome Distinto (DN) a ser designado a um
assinante de correio do SmartCloud Notes. Esse campo é
aplicável apenas a operações que referenciam assinaturas do
SmartCloud Notes.
Nota: As assinaturas do SmartCloud Notes requerem um nome
de usuário exclusivo, que é definido conforme o valor NotesDN
especificado. Se um NotesDN não for especificado, será gerado
um a partir dos valores GivenName e FamilyName exclusivos
especificados.
AssignSeat.
Uma vez que um usuário híbrido do SmartCloud Notes tenha
sido fornecido com o uso de uma operação do servidor de
integração Add e AssignSeat, seu nome não poderá ser alterado,
tanto por uma operação do servidor de integração Rename
quanto manualmente pela interface do usuário do
administrador BSS. O nome de usuário do SmartCloud Notes
precisaria ser alterado em vez disso no ambiente local
especificando um valor de DN diferente.
AssignTo
Especifica o novo assinante (destino) a ser designado a recursos
removidos ou redesignados do usuário de origem.
Nota: A redesignação de recursos é suportada apenas para
assinaturas de colaboração.
Department
Especifica a designação de departamento do usuário.
JobTitle
Especifica o valor do campo Título do Cargo para o registro de
perfil do usuário.
Update.
Country
Especifica o valor do campo País para o registro de perfil do
usuário usando valores do código de caractere ISO 2.
Update.
Esse campo é opcional para as operações
RevokeSeat e Remove.
Update.
50
Tabela 4. Nomes e Descrições dos Campos de Operação do Arquivo de Fornecimento (continuação)
Nome do campo
Telephone
Especifica o valor do campo Telefone para o registro de perfil
do usuário.
Update.
Mobile
Especifica o valor do campo Remoto para o registro de perfil
do usuário.
Update.
Fax
Especifica o valor do campo Fax para o registro de perfil do
usuário.
Update.
Address
Especifica o valor do campo Endereço para o registro de perfil
do usuário.
Update.
SuppressInvitation
Em combinação com um valor SUPPRESS_ALL, especifica que as
operações Add e AssignSeat não enviam ao usuário um e-mail
de convite. Uma operação ResendInvitation pode ser usada
posteriormente para enviar o convite.
AssignSeat.
Se o campo não for especificado, ou se o valor do campo for
SUPPRESS_NONE, o convite será enviado (padrão).
FederationType
Especifica o tipo de federação do usuário. Os seguintes valores
estão disponíveis:
Update.
v Se o tipo de federação da organização for Não federado, use
NON_FEDERATED para o valor FederationType do usuário.
v Se o tipo de federação da organização for Federado, use
FEDERATED para o valor FederationType do usuário.
v Se o tipo de federação da organização for Modificado, use
MODIFIED_FEDERATED para o valor FederationType do usuário.
v Se o tipo de federação da organização for Parcial, use
NON_FEDERATED, FEDERATED ou MODIFIED_FEDERATED para o
valor FederationType do usuário.
Se o valor não seguir essas regras, ou for um valor inválido, o
servidor de integração gerará um erro.
Se nenhum valor for especificado, o tipo de federação padrão
da empresa será usado. Se o tipo de federação da organização
for Parcial, NON_FEDERATED será usado.
CollabExtraStorage
Especifica a quantia de armazenamento extra, em GB, da cota
de Arquivos para o ID da assinatura de colaboração ou ID da
assinatura em pacote configurável especificado no campo
subscriptionID.
MailExtraStorage
Especifica a quantia de armazenamento extra, em GB, da cota
de Correio para o ID da assinatura de correio ou ID da
assinatura em pacote configurável especificado no campo
subscriptionID.
Activation
Inclui o usuário especificado, força uma verificação positiva e
ativa o usuário dentro da mesma operação.
Esse campo é opcional para a operação
ChangeStorage.
Insira um número inteiro maior ou igual a 0.
Esse campo é opcional para a operação
ChangeStorage.
Insira um número inteiro maior ou igual a 0.
A palavra-chave é FORCE_ACTIVATION.
Essa operação é ideal para usuários que não possuem acesso à
web para concluir a ativação, como os assinantes do IBM
SmartCloud Notes. Ela está disponível para usuários federados
para quem você deseja forçar uma verificação positiva e
concluir automaticamente a ativação.
A operação somente é válida se o usuário for
FEDERATED e a organização tiver desativado a
verificação de email. A verificação é forçada.
Nota: Como a verificação de email deve ser
desativada, você deve certificar-se de que o
usuário é um membro válido de um domínio de
email que a sua organização controle.
51
“Exemplos: Arquivos de Mudanças de Fornecimento de Usuário”
Uma vez que você for permitido usar o servidor de integração, e estiver familiarizado com os requisitos
de nomenclatura de arquivo e de especificação de atributo, é possível criar arquivos de mudanças de
fornecimento de usuário para fazer upload de informações de seu sistema de gerenciamento de dados
local.
“Especificando uma Assinatura em Pacote Configurável” na página 59
É possível especificar uma assinatura em pacote configurável usando o servidor de integração.
“Especificando uma Assinatura de Acessório” na página 61
É possível fornecer aos usuários assinaturas de acessório usando o servidor de integração.
“Balanceamento de Carga e Limitações de Processamento” na página 72
O servidor de integração usa limites de processamento para ajudar no balanceamento de carga.
Exemplos: Arquivos de Mudanças de Fornecimento de Usuário
local.
Revise “Criando Arquivos de Mudanças de Fornecimento de Usuário” na página 46 antes de continuar.
O cabeçalho do arquivo especifica os nomes dos campos de operação como eles estão definidos na
primeira coluna da Tabela 3 em “Criando Arquivos de Mudanças de Fornecimento de Usuário” na página
46 (sem distinção entre maiúsculas e minúsculas). As linhas restantes definem valores para os campos
correspondentes. Cada linha deve terminar com um caractere apropriado de retorno de linha ou feed de
linha. Em plataformas Windows, use \r\n (0x0D 0x0A) e em plataformas UNIX ou Linux, use \n (0xA).
Embora o servidor de integração possa processar arquivos com um ou outro formato de término de linha,
você deve usar o formato de transferência TEXT para assegurar que os términos de linha apropriados
sejam enviados para, e recebidos de, o servidor FTP intermediário.
Siga estas regras ao codificar operações em um arquivo de mudanças de fornecimento:
Nota: Os arquivos de mudança de fornecimento do usuário do servidor de integração usam um formato
CSV (valores separados vírgula); consulte RFC 4180 para obter informações adicionais. Detalhes sobre
esse formato estão disponíveis na web em sites como Wikipedia.
v Inclua os dados do campo relevantes na ordem de campo CSV correta como a seguir; consulte a Tabela
3 em “Criando Arquivos de Mudanças de Fornecimento de Usuário” na página 46.
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,
language,timeZone,password,altEmailAddress,notesTemplate,notesDN,
assignTo,department,jobTitle,country,telephone,mobile,fax,address,
suppressInvitation,federationType,
v
v
v
v
Use um conjunto de caracteres UTF-8.
Inclua um valor vazio para um campo opcional ou não aplicável usando vírgulas consecutivas.
Codifique uma sequência de comprimento zero para um campo como “”.
Coloque os valores do campo entre aspas duplas se o valor contiver os caracteres vírgula ou aspas
duplas, ou contiver espaços no início ou final do valor. Os outros valores dos campos podem ser
colocados opcionalmente entre aspas duplas:
52
– Os valores dos campos podem ser colocados entre aspas duplas, se desejado, independentemente
dos caracteres no campo.
– As aspas duplas devem ser usadas para os valores dos campos que incluem uma vírgula.
– As aspas duplas devem ser usadas para os valores dos campos que possuem um ou mais espaços
no início ou final do valor.
– Codifique um caractere aspas duplas usando um par de caracteres aspas duplas, por exemplo
...,"John ""that guy"" Doe", ...
v Uma operação de atualização contendo um valor do campo vazio (por exemplo ,,) deixa o campo
configurado para seu valor existente.
v Uma atualização que especifica uma sequência de comprimento zero substitui o valor do campo por
uma sequência de comprimento zero.
v Os nomes das operações não fazem distinção entre maiúsculas e minúsculas.
v É possível omitir vírgulas à direita, no final de uma instrução. Por exemplo, as duas instruções a seguir
produzem o mesmo resultado:
[email protected],Add,85180,,Sam,Daryn,en_US,America/New_York
[email protected],Add,85180,,Sam,Daryn,en_US,America/New_York,,,,,,,,,,,,
v É possível omitir nomes de campos, e vírgulas, no final de uma instrução se eles não forem necessários
para a operação. Por exemplo, se nenhum campo for necessário depois de TimeZone, valores para os
seguintes campos apenas são suficientes:
emailAddress,Action,SubscriptionId,SubscriptionId2,GivenName,FamilyName,Language,TimeZone
Exemplos que ilustram os valores dos campos de amostra para vários objetivos de operação são os
seguintes:
v Incluir um novo assinante com uma assinatura de colaboração.
[email protected],Add,85180,,Sam,Daryn,en_US,America/New_York
[email protected],Add,,,Randi,Factor,en_US,America/New_York
[email protected],Add,85181,,Zach,Jones,en_US,America/New_York
v Atualizar as informações de pessoa para um assinante.
[email protected],Update,,,,,zh_CN,Asia/Shanghai
[email protected],Update,,,,Jones
[email protected],Update,,,Zach
v Suspender um assinante.
[email protected],Suspend
v Continuar um assinante.
[email protected],Resume
v Designar uma assinatura do IBM SmartCloud iNotes a um assinante existente que possui um lugar de
colaboração.
[email protected],AssignSeat,85292,,,,,,,[email protected]
v Designar uma assinatura do SmartCloud iNotes para um assinante existente que não possui assinaturas
de lugar.
v Designar uma assinatura do IBM SmartCloud Notes a um assinante existente que possui um lugar de
colaboração.
v Designar uma assinatura de Meetings a um assinante existente que possui uma assinatura do
SmartCloud iNotes.
[email protected],AssignSeat,85180
53
v Alterar um lugar de assinatura existente retido por um assinante de uma assinatura para outra, por
exemplo, de Meetings15 para Meetings20.
[email protected],ChangeSeat,85179
v Revogar um lugar de colaboração existente designado ao assinante.
[email protected],RevokeSeat,COLLAB
v Revogar um lugar de colaboração de um assinante e redesignar o conteúdo do lugar a um assinante
diferente (por exemplo, de [email protected] para [email protected]).
[email protected],RevokeSeat,COLLAB,,,,,,,,,,[email protected]
v Remover um assinante.
[email protected],Remove
v Remover um assinante e redesignar seu conteúdo de colaboração a um outro assinante.
[email protected],Remove,,,,,,,,,,,[email protected]
v Incluir um assinante apenas com uma assinatura do SmartCloud iNotes e configurar uma senha que o
usuário deve alterar no primeiro uso.
[email protected],Add,85292,,Sam,Daryn,en_US,America/New_York,secret
v Incluir um assinante com assinaturas de Meetings e do SmartCloud iNotes e configurar uma senha que
o usuário deve alterar no primeiro uso.
[email protected],Add,85180,85292,Sam,Daryn,en_US,America/New_York,secret
v Incluir um assinante com assinaturas de Meetings e do SmartCloud iNotes e enviar um convite a um
email alternativo contendo um link para configurar a senha.
[email protected],Add,85180,85292,Sam,Daryn,
en_US,America/New_York,,[email protected],
v Incluir um assinante apenas com uma assinatura do SmartCloud Notes e configurar uma senha que o
usuário deve alterar no primeiro uso.
Nota: Sempre configure uma senha descartável ao incluir um assinante; não envie um convite a um
email alternativo para configurar a senha.
[email protected],Add,86796,,Sam,Daryn,en_US,America/New_York,secret,,
mail90.ntf,Sam Daryn/abx/IBM
v Incluir um assinante com assinaturas de Meetings e do SmartCloud Notes e configurar uma senha que
o usuário deve alterar no primeiro uso.
Nota: Sempre configure uma senha descartável ao incluir um assinante do SmartCloud Notes; não
envie um convite a um email alternativo para configurar a senha.
[email protected],Add,85180,86796,Sam,Daryn,en_US,America/New_York,secret,,
mail90.ntf,Sam Daryn/abx/IBM
v Renomear um assinante.
[email protected],Rename,,,,,,,,[email protected]
v Suprimir um convite.
[email protected],Add,85180,,Lu,Suarez,en_US,America/Boston,,,,,,,,,,,,,SUPPRESS_ALL
[email protected],Add,,,Viv,Hanley,en_US,America/Boston,,,,,,,,,,,,,SUPPRESS_ALL
[email protected],AssignSeat,85180,,,,,,,,,,,,,,,,,,SUPPRESS_ALL
v Reenviar um convite.
[email protected],ResendInvitation
[email protected],ResendInvitation
v Especificar um tipo de federação.
[email protected],Add,85180,,Jas,Haj,en_US,America/Boston,,,,,,,,,,,,,,MODIFIED_FEDERATED
[email protected],Update,,,,,,,,,,,,,,,,,,,,FEDERATED
54
v Usando o campo notesTemplate, é possível especificar um modelo de email do Notes usando um
formato "name,version,locale" (as aspas duplas são necessárias), conforme mostrado na amostra a seguir,
para especificar a versão e idioma específicos a usar para o modelo nomeado:
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,timeZone,
password,altEmailAddress,notesTemplate
[email protected],add,143422,,Cheryl,Smith,en_US,,passw0rd,,"StdR85Mail,8.5.3,en_US"
Nota: Existem diversas variações disponíveis ao usar o formato
"name,version,locale,extension_forms_file".
Se um locale não for especificado, o modelo que corresponde ao idioma especificado para as
preferências de idioma da sua conta é usado. Isso também se iguala para o idioma especificado no
campo language do arquivo CSV se estiver incluindo o usuário.
[email protected],add,143422,,Cheryl,Smith,en_US,,passw0rd,,"StdR85Mail,8.5.2"
Se o arquivo CSV especificar um valor de language diferente do especificado no campo notesTemplate
(formato "name,version,locale"), a configuração de locale especificada no campo notesTemplate substitui o
valor do campo language do arquivo CSV. Por exemplo, o seguinte usuário tem espanhol (es_ES)
especificado no campo language, mas inglês especificado para a configuração de locale no campo
notesTemplate, assim, o modelo em inglês (en_US) será usado:
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,
timeZone,password,altEmailAddress,notesTemplate,notesDN,assignTo,department,region,
regionAdministrated,jobTitle,country,telephone,mobile,fax,address
[email protected],add,143422,,Cheryl,Smith,es_ES,,passw0rd,,"StdR85Mail,8.5.3,en_US"
Se uma versão for especificada, por exemplo, StdR85Mail,8.5.3,en_US como no exemplo anterior, a
versão especificada será usada. Se a configuração de versão for nula ou não especificada, a versão mais
recente do modelo nomeado será usada.
timeZone,password,altEmailAddress,notesTemplate
[email protected],add,143422,,Cheryl,Smith,en_US,,passw0rd,,"StdR85Mail,,en_US"
Se a configuração de locale for nula ou não especificada e a configuração do campo language do arquivo
CSV não for especificada, o idioma na conta será usado.
[email protected],update,,,,,,,,,"StdR85Mail,8.5.2"
Esse exemplo ilustra como aplicar um arquivo de formulário de extensão para um novo usuário da
web do SmartCloud Notes, usando o código de idioma e a versão padrão para o modelo
nomeadoStdR9Mail em que o nome do arquivo de formulário de extensões é forms9_x.nsf.
[email protected],add,,,,,,,,,"StdR9Mail,,,forms9_x.nsf"
Nota: Se estiver excluindo a especificação do arquivo de formulários de extenção, por exemplo, em
umaoperação de atualização, omitir o nome do arquivo de formulários de extensão não é suficiente
para removê-lo; em vez disso, especifique um valor de <delete> no seguinte formato:
[email protected],add,,,,,,,,, ",,,<delete>"
Nota: Para informações relacionadas e de suporte sobre a especificação de um modelo de correio,
consulte a descrição de notesTemplate em Criando arquivos de mudança de fornecimento do usuário.
v Inclua um usuário híbrido do SmartCloud Notes que esteja listado no diretório Domino.
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,timeZone,password
[email protected],Add,57163,,Jayne,Hybrid12,,,passw0rd
55
v Designar um lugar do SmartCloud Notes a um usuário de colaboração existente.
timeZone,password,altEmailAddress
[email protected],Assignseat,57163,,Jayne,Hybrid06,,,,[email protected]
v Incluir um usuário híbrido do SmartCloud Notes e designar um modelo de correio para esse usuário.
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,language,timeZone,password,
altEmailAddress,notesTemplate
[email protected],Add,57163,,Jayne,Hybrid11,,,passw0rd,,callc10727mail
v Designar um lugar do SmartCloud Notes e especificar um nome de modelo de correio para um usuário
de colaboração existente.
altEmailAddress,notesTemplate
[email protected],Assignseat,57163,,Jayne,Hybrid06,,,,[email protected],callc10727mail
v Atualizar um ou mais usuários existentes para usar um modelo de correio diferente.
– Ativar um usuário existente para usar um modelo de correio diferente daquele que eles estão
usando atualmente.
password,altEmailAddress,notesTemplate,notesDN,Department,jobTitle,Country,telephone,mobile,fax,address
[email protected],Update,,,Jayne,Hybridnew28,,,,,CALLC10727Mail
– Ativar todos os usuários existentes para usar um modelo de correio diferente daquele que eles estão
usando atualmente.
password,altEmailAddress,notesTemplate,notesDN,Department,jobTitle,Country,telephone,mobile,fax,address
[email protected],Update,,,,,,,,,CALLC10727Mail
Ao incluir ou atualizar um modelo de correio ou nome de usuário híbrido ou não híbrido do SmartCloud
Notes usando um arquivo de mudanças de fornecimento; existem advertências para o uso do campo
notesDN. Isso é aplicável quando o givenName ou familyName de um usuário difere de suas configurações
de notesDN. Os exemplos são os seguintes:
v Operações Update
Se um administrador desejar atualizar o givenName ou familyName de um usuário do SmartCloud
Notes, ele não deverá especificar nada no campo notesDN. Especificar um valor como uma operação de
atualização falha com a mensagem ERRO: Validação de Atributo do Notes falhou.
– Por exemplo, a seguinte operação Update falharia:
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,notesDN
[email protected],Update,,,Jaynerevised,HybridNew10revised,Jayne HybridNew10/HighAvail
– Por exemplo, a seguinte operação Update obteria êxito:
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,notesDN
[email protected],Update,,,Jaynerevised,HybridNew10revised,
Se um administrador desejar atualizar o modelo customizado de um usuário do SmartCloud Notes, ele
não deverá especificar nada no campo notesDN.
– Por exemplo, a seguinte operação Update falharia:
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,notesTemplate,notesDN
[email protected],Update,,,Anna,Jones,E3_2319A,Anna Jones/JR OCT 19
– Por exemplo, a seguinte operação Update obteria êxito:
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,notesTemplate,notesDN
[email protected],Update,,,Anna,Jones,E3_2319A
v Operações Add
Se um administrador incluir um usuário do SmartCloud Notes e especificar um givenName ou
familyName diferente do nome distinto local do usuário, ele deverá especificar o nome distinto correto
no campo notesDN.
– Por exemplo, a seguinte operação Add falharia:
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,password,notesDN
[email protected],Add,57163,,Jaynerevised,HybridNew13revised,passw0rd
– Por exemplo, a seguinte operação Add obteria êxito:
56
emailAddress,action,subscriptionId,subscriptionId2,givenName,familyName,password,notesDN
[email protected],Add,57163,,Jaynerevised,HybridNew13revised,passw0rd,Jayne HybridNew13/HighAvail
v Operações AssignSeat
O comportamento de uma assinatura do SmartCloud Notes é o seguinte:
– Se givenName e familyName forem nulos e notesDN for especificado, use o notesDN como o DN do
usuário.
– Se givenName e familyName forem especificados e notesDN for nulo, use o givenName e o familyName
para construir o DN.
– Se givenName e familyName forem especificados e notesDN for especificado, use o notesDN como o
DN do usuário e ignore givenName e familyName.
– Se o givenName e o familyName forem nulos e notesDN for nulo, use o givenName e o familyName da
conta como o DN do usuário.
– Para usuários híbridos do SmartCloud Notes, deve existir uma entrada no Diretório do IBM Domino
com o DN resultante.
– Para usuários não híbridos do SmartCloud Notes, não deve haver uma entrada existente no
Diretório do IBM Domino com o DN resultante.
– O registro de conta do usuário não é atualizado com quaisquer valores especificados pelos campos
givenName ou familyName.
Várias entradas de arquivo de fornecimento de amostra para assinaturas em pacote configurável são
fornecidas da seguinte maneira:
v Inclua um usuário e forneça uma assinatura em pacote configurável que inclua Engage e SmartCloud
iNotes.
[email protected],Add,91319,,Sarah,Davidson,en_US,America/New_York
v Revogue uma assinatura em pacote configurável a partir de um usuário e redesigne os dados do
usuário de colaboração para outro usuário.
[email protected],RevokeSeat,BUNDLE,,,,,,,,,,[email protected]
v Designe uma assinatura em pacote configurável para um usuário que não tenha lugar existente.
v Remova o assinante e redesigne o conteúdo de colaboração para outro usuário (somente dados de
Arquivos e Atividades podem ser redesignados, todos os outros dados do aplicativo SmartCloud
Engage e dados de correio são excluídos).
[email protected],Remove,,,,,,,,,,,[email protected]
v Altere a designação de lugar de um usuário com assinaturas individuais do SmartCloud Engage e
SmartCloud iNotes para uma assinatura em pacote configurável.
[email protected],ChangeSeat,91319
v Altere a designação de lugar de um usuário com assinaturas individuais do SmartCloud Engage para
uma assinatura em pacote configurável.
[email protected],ChangeSeat,91319,,,,,,,[email protected]
v Altere a designação de lugar de um usuário com uma assinatura em pacote configurável para uma
assinatura individual do SmartCloud Engage and SmartCloud iNotes.
[email protected],ChangeSeat,85180,85292
v
Altere a designação de lugar de um usuário que foi fornecido em uma assinatura em pacote
configurável para apenas SmartCloud Engage.
[email protected],ChangeSeat,85180,DELETEMAIL
v Altere a designação de lugar de um usuário que foi fornecido em uma assinatura em pacote
configurável para apenas SmartCloud iNotes.
[email protected],ChangeSeat,85292,DELETECOLLAB
v Revogue uma assinatura de pacote configurável a partir de um usuário e redesigne os dados do
usuário de colaboração para outro usuário.
[email protected],RevokeSeat,BUNDLE,,,,,,,,,,[email protected]
57
v Designe um lugar do SmartCloud Notes Traveler para um assinante de um usuário existente do
SmartCloud Notes.
emailAddress,action,subscriptionId
[email protected],Assignseat,57163
v Inclua e forneça a um usuário uma assinatura do SmartCloud Notes e uma assinatura de acessório do
SmartCloud Notes Traveler.
[email protected],Add,91319,91320,Sarah,Davidson,en_US,America/New_York
configurável do SmartCloud Notes e IBM SmartCloud Engage e assinatura do SmartCloud Notes
Traveler para SmartCloud Notes. A assinatura do Traveler é preservada.
[email protected],ChangeSeat,85180,DELETECOLLAB
configurável e a assinatura do SmartCloud Notes Traveler para apenas IBM SmartCloud Engage. A
assinatura do Traveler foi removida.
[email protected],ChangeSeat,85180,DELETEMAIL
v Designe 15 GB de armazenamento para a cota de Arquivos do IBM SmartCloud Engage.
[email protected],ChangeStorage,85180,,,,,,,,,,,,,,,,,,,,15,
v Designe 15 GB de armazenamento para a cota de Correio do SmartCloud iNotes.
[email protected],ChangeStorage,85292,,,,,,,,,,,,,,,,,,,,,15
v Designe 15 GB de armazenamento para a cota de Correio e Arquivos em um pacote configurável do
IBM SmartCloud Engage e SmartCloud iNotes.
[email protected],ChangeStorage,91319,,,,,,,,,,,,,,,,,,,,15,15
v Inclua um usuário federado e force simultaneamente sua verificação e ativação automáticas usando a
opção Ativação em uma operação Incluir. Note que essa operação tem advertências que requerem que
os usuários sejam federados e que a verificação de email seja desativada, consulte Criando arquivos de
mudanças de fornecimento de usuário para informações adicionais. As seguintes condições estão presentes
nesses exemplos:
altEmailAddress,Activation,FederationType,notesTemplate,notesDN,assignTo
– A seguinte operação Incluir incluirá e automaticamente ativará o usuário:
[email protected],Add,,,Federated,User16,,,,,FORCE_ACTIVATION,FEDERATED
– A seguinte operação Incluir falhará com um erro 1095 (ERROR_INVALID_ACTIVATION_VALUE) porque o
valor de Ativação não está definido para FORCE_ACTIVATION:
[email protected],Add,,,Nonfederated,User12,,,,,INVALIDABC,,,,
– As seguintes operações Incluir falharão com um erro 1096 (ERROR_CANNOT_FORCE_ACTIVATION)
porque o valor de Ativação não está definido para FORCE_ACTIVATION,mas FederationType não está
definido para FEDERATED:
[email protected],Add,,,Nonfederated,User11,,,,,FORCE_ACTIVATION,,,,
[email protected],Add,,,Federated,User17,,,,,FORCE_ACTIVATION,NON_FEDERATED,,,
[email protected],Add,,,Federated,User18,,,,,FORCE_ACTIVATION,MODIFIED_FEDERATED,,,
– A seguinte operação Incluir falhará com um erro 1056 (ERROR_FEDERATION_ONLY_PARTIAL) porque a
organização não está configurado para permitir login de usuário federado:
[email protected],Add,,,Federated,User6,,,,,FORCE_ACTIVATION,FEDERATED,,,
58
“Criando Arquivos de Mudanças de Fornecimento de Usuário” na página 46
“Concluindo o Fornecimento de Assinatura para Usuários Híbridos do SmartCloud Notes” na página 62
É possível usar o servidor de integração para concluir o fornecimento de assinatura de correio para
usuários híbridos do IBM SmartCloud Notes.
“Arquivos de Rastreio do Servidor de Integração” na página 74
O servidor de integração gera um arquivo de rastreio para cada arquivo de mudanças que ele processa.
Especificando uma Assinatura em Pacote Configurável
É possível especificar uma assinatura em pacote configurável usando o servidor de integração.
O empacotamento de dados de assinatura para vários usuários permite especificar a mesma assinatura de
colaboração e/ou sistema de mensagens para vários usuários simultaneamente. Isso fornece uma
alternativa para especificar a assinatura e o fornecimento de usuário individualmente no arquivo de
mudanças de fornecimento de usuário ou individualmente na interface com o usuário administrador do
IBM SmartCloud for Social Business.
É possível especificar uma assinatura em pacote configurável inicialmente para fazer upload de usuários
em massa e para fazer mudanças aos usuários existentes. Para algumas operações, é possível alterar um
usuário de um assinante em pacote configurável para um assinante de lugar único ou um assinante de
lugar único para um assinante em pacote configurável.
Para iniciar esse processo de fornecimento de usuário, você deve primeiramente solicitar a ativação do
servidor de integração ao responsável pelo atendimento ao cliente e, em seguida, configure seu site FTP
conforme instruído. Consulte Solicitando a Ativação do Servidor de Integração para obter detalhes.
Quando você pede uma oferta empacotada do IBM SmartCloud Engage e do IBM SmartCloud Notes, o
pacote configurável é configurado como a seguir:
v A conta de sua organização conterá uma única assinatura que inclui as autorizações de assinatura
empacotada especificadas.
v Cada usuário é fornecido como um lugar no pacote configurável; esse lugar incluirá as autorizações
designadas do IBM SmartCloud Engage e do IBM SmartCloud Notes.
v Todos os usuários são fornecidos de forma idêntica, por exemplo, não é possível fornecer alguns
usuários apenas com o IBM SmartCloud Engage e outros apenas com o IBM SmartCloud Notes.
Nota: Se um usuário for alterado de uma assinatura de lugar individual para uma assinatura em pacote
configurável, seu endereço de email será preservado.
Capture suas informações de assinatura em pacote configurável no formato de arquivo CSV necessário e
faça o upload do arquivo CSV no servidor de integração. Todas as operações de arquivo de mudanças de
59
fornecimento de usuário, conforme listadas no tópico Criando Arquivos de Mudanças de Fornecimento
de Usuário, suportam assinaturas empacotadas. As considerações específicas para essas operações para as
assinaturas em pacote configurável são:
Operações Add e AssignSeat
Use uma operação Add ou AssignSeat para incluir um usuário e designar uma assinatura de
colaboração e/ou correio (único lugar) como um usuário empacotado.
Uma operação Add ou AssignSeat retorna um erro quando você tenta executar o seguinte:
v Incluir um usuário em um serviço de colaboração, serviço de correio ou assinatura em pacote
configurável quando o usuário já é fornecido por uma assinatura em pacote configurável.
v Incluir um usuário como parte de uma assinatura empacotada quando o usuário já é fornecido
como um serviço de colaboração e/ou um assinante de serviço de correio.
ChangeSeat
Use uma operação ChangeSeat para substituir uma assinatura de lugar único do por uma
assinatura em pacote configurável.
v Se o usuário for inscrito em um serviço de colaboração e um serviço de correio, esse usuário
será trocado para a assinatura empacotada e seu correio será preservado.
v Se o usuário for inscrito em um único serviço de colaboração, um serviço de correio ou uma
assinatura empacotada, ocorrerá o seguinte:
– A assinatura de destino é uma assinatura empacotada
- Se o usuário for inscrito em um lugar de colaboração e uma assinatura de correio, o
usuário será trocado para a assinatura em pacote configurável e removido de sua
designação de assinatura de lugar único. O conteúdo de assinatura de colaboração (por
exemplo, dados de Perfis, Arquivos, Comunidades e assim por diante) e os dados de
correio são preservados e reassociados à assinatura em pacote configurável.
– A assinatura de origem é uma assinatura empacotada
- É possível especificar a assinatura empacotada de origem em um campo e a assinatura de
destino como um novo campo na operação ChangeSeat.
- Os valores de palavra-chave DELETECOLLAB e DELETEMAIL permitem alterar um usuário de
uma assinatura empacotada para uma assinatura de correio ou colaboração de único
lugar.
Remove e RevokeSeat
Essas operações removem um usuário da assinatura em pacote configurável ou revogam o lugar
de um usuário na assinatura em pacote configurável, respectivamente.
v Se nenhum novo usuário for listado, uma operação RevokeSeat removerá o usuário da
assinatura mas não excluirá seus dados de serviço de correio ou colaboração. A palavra-chave
BUNDLE é necessária.
v Se nenhum novo usuário for listado, uma operação Remove removerá o usuário da assinatura e
excluirá todos os seus dados de serviço de correio e colaboração.
Se você também especificar um valor assignTo, será possível redesignar um correio de usuário
removido e os dados de serviço de colaboração para um usuário designado.
Se você especificar um valor assignTo para uma operação revokeSeat, os dados de serviço
disponíveis serão redesignados ao usuário assignTo, outros dados de serviço serão excluídos e a
assinatura original será removida. Se não houver dados de assinatura que possam ser
redesignados, uma mensagem de erro será exibida.
v Apenas dados de assinatura de Arquivos e Atividades podem ser redesignados.
v As assinaturas de correio do IBM SmartCloud Notes não podem ser redesignadas.
v As assinaturas de correio do IBM SmartCloud iNotes não podem ser redesignadas.
60
v Se os dados de correio não puderem ser redesignados, eles serão perdidos, por exemplo, se um
usuário assignTo já tiver uma assinatura de correio, somente os dados de serviço de
colaboração existentes serão redesignados, mesmo se o usuário for um assinante em pacote
configurável.
“Exemplos: Arquivos de Mudanças de Fornecimento de Usuário” na página 52
local.
ativação.
Especificando uma Assinatura de Acessório
É possível fornecer aos usuários assinaturas de acessório usando o servidor de integração.
É possível fornecer aos usuários assinaturas de acessório como SmartCloud Notes Traveler, acesso ao
BlackBerry Enterprise Server, Documentos do IBM SmartCloud, Serviços Hospedados do BlackBerry e
Feed de Dados de Retenção de Arquivamento. As assinaturas de acessório requerem uma assinatura de
base compatível. Por exemplo, para usar o Traveler no IBM SmartCloud for Social Business, o usuário
que está sendo fornecido precisa primeiramente ter um ID válido de assinatura do Notes. O ID da
assinatura de base deve ser especificado no fornecimento do usuário.
Para iniciar esse processo de fornecimento de usuário, você deve primeiramente solicitar a ativação do
servidor de integração ao responsável pelo atendimento ao cliente e, em seguida, configure seu site FTP
conforme instruído. Consulte Solicitando a Ativação do Servidor de Integração para obter detalhes.
As operações de fornecimento que suportam as assinaturas de acessório são Add, Remove, AssignSeat, e
RevokeSeat.
Capture as informações de assinatura de acessório no formato de arquivo CSV necessário e faça o upload
do arquivo CSV no servidor de integração. Todas operações de arquivo de mudança de fornecimento de
usuário são descritas no tópico Criando Arquivos de Mudanças de Fornecimento de Usuário. As
considerações específicas para essas operações para as assinaturas de acessório são:
Incluir
Use Add para autorizar um assinante a uma assinatura de acessório. Especifique o ID da
assinatura de acessório e o ID da assinatura de base compatível no campo SubscriptionId ou
SubscriptionId2.
AssignSeat
Use AssignSeat para autorizar um usuário a uma assinatura de acessório. Especifique o ID da
61
assinatura de acessório no campo SubscriptionId. Para designar um lugar de assinatura de
acessório, o assinante deve ter um lugar de assinatura compatível existente.
Remover
Use Remove para remover um usuário; quaisquer assinaturas de acessório a qual o usuário esteja
autorizado serão revogadas e os dados de acessório serão excluídos.
ChangeSeat
Não é possível usar ChangeSeat para alterar de uma assinatura de acessório para outra. Quando
ChangeSeat for usado em uma assinatura de base e houver uma assinatura de acessório associada
a essa assinatura de base, a assinatura de acessório também será transferida para a nova
assinatura de base.
RevokeSeat
Use RevokeSeat para especificar uma palavra-chave de assinatura de acessório para o campo
SubscriptionId para revogar um tipo específico de assinatura de acessório. Use a
palavra-chaveBES_ACCESS, IBM_DOCS, BLACKBERRY_HOSTED, BLACKBERRY_HOSTED_MDS, TRAVELER, ou
RETENTION para especificar o tipo de assinatura que estiver revogando. O uso de RevokeSeat em
uma assinatura de base também revogará quaisquer assinaturas de acessório associadas.
A redesignação das assinaturas de acessório não é suportada. Por exemplo, especificar uma operação
RevokeSeat ou Remove que usa um qualificador assignTo para redesignar recursos de dados para outro
usuário redesignará somente os dados de colaboração; quaisquer dados de acessório serão excluídos
ativação.
Concluindo o Fornecimento de Assinatura para Usuários Híbridos do
SmartCloud Notes
É possível usar o servidor de integração para concluir o fornecimento de assinatura de correio para
usuários híbridos do IBM SmartCloud Notes.
Na configuração híbrida do SmartCloud Notes, alguns usuários acessam seu correio a partir do ambiente
do servidor local e alguns a partir de um ambiente do SmartCloud Notes.
É possível usar uma entrada Add ou AssignSeat em um arquivo de mudanças de fornecimento de usuário
para provisionar a diversos usuários híbridos do SmartCloud Notes uma assinatura de correio do
SmartCloud Notes. Porém, você deve iniciar com um novo arquivo de mensagens; transferir um arquivo
mensagens local para o serviço não é permitido.
62
Informações e requisitos importantes sobre o fornecimento do usuário estão incluídos em Completando
uma lista de verificação de fornecimento de usuário na documentação Administrando oSmartCloud
Notes. Antes de fazer o fornecimento de usuários, conclua as tarefas descritas nos seguintes tópicos nessa
documentação:
v Configurando o serviço
v Concluindo a configuração
v Preparando o fornecimento de usuário
Também consulte, mas não execute as etapas, dos parâmetros introdutórios no tópico Fornecendo usuários
sem transferir arquivos de mensagens na documentação Administrando o SmartCloud Notes: Ambiente
Híbrido.
Os seguintes cenários são suportados:
v Uma conta para o usuário já existe e algumas assinaturas foram designadas já usando o servidor de
integração. A identidade da conta, por exemplo, endereço de email, corresponde ao endereço de email
local do SmartCloud Notes.
1. Use uma entrada AssignSeat em um arquivo de mudanças de fornecimento de usuário para
designar aos usuários uma assinatura do SmartCloud Notes. Certifique-se de usar o endereço de
email da identidade da conta que corresponde ao endereço de email local do usuário.
v Uma conta para o usuário já existe, mas nenhuma assinatura foi designada.
1. Use uma entrada AssignSeat em um arquivo de mudanças de fornecimento de usuário para
designar ao usuário uma assinatura do SmartCloud Notes.
v Não existe ainda nenhuma conta para o usuário
1. Use uma entrada Add em um arquivo de mudanças de fornecimento de usuário para incluir o
usuário na conta de sua organização. Opcionalmente, é possível designar ao usuário uma assinatura
do SmartCloud Notes e assinaturas dos serviços de colaboração na mesma instrução Add.
Ao transferir por upload o seu arquivo de mudanças de fornecimento para o servidor de integração, o
processo de upload verifica as entradas do arquivo para um nome de usuário, nome de domínio, nome
de modelo de correio válido (e atributos opcionais especificados para o nome do modelo de correio) e se
o usuário já foi configurado como um usuário híbrido do SmartCloud Notes. Se alguma dessas
verificações de parâmetros falhar, esse usuário será rejeitado e uma instrução correspondente será gerada
no arquivo de relatório associado. A especificação de um endereço de email de identidade da conta que
não corresponde ao endereço de email local do usuário também retorna um erro.
Nota: As considerações a seguir existem ao renomear um usuário que também foi fornecido como
usuário híbrido do SmartCloud Notes:
v O uso de uma operação de mudança e a especificação somente do valor de NotesDN do usuário (e não
de seu nome) retornará um erro.
v O uso da operação de mudança para renomear uma conta do usuário em que o nome de usuário
especificado (endereço de email) não corresponde ao endereço de email do SmartCloud Notes do
usuário retornará um erro.
v O uso da operação de mudança para renomear uma conta do usuário em que o nome de usuário é o
endereço de email do SmartCloud Notes retornará um erro.
v O valor NotesDN só é reconhecido ao alterar de um lugar não SmartCloud Notes para uma assinatura
que contenha um lugar do SmartCloud Notes.
63
“Exemplos: Arquivos de Mudanças de Fornecimento de Usuário” na página 52
local.
“Valores de Código de Erro para Arquivos de Mudanças Processados” na página 81
O servidor de integração cria um arquivo de relatório geral para cada lote de arquivos de mudanças da
empresa que ele processa e um arquivo de rastreio correspondente individual para cada arquivo de
mudanças que ele processa.
Integração do diretório
A integração de diretório permite sincronizar o diretório corporativo de sua organização com o diretório
de contatos corporativos do SmartCloud iNotes. Isso não cria, modifica ou exclui contas de usuário do
SmartCloud iNotes.
Os componentes que participam do ambiente do servidor de integração são mostrados a seguir.
Componentes adicionais que são gerenciados na nuvem são omitidos dessa lista.
v Diretório corporativo do cliente
O diretório corporativo do cliente contém entradas de pessoa e de grupo e é geralmente mantido
localmente por você em um sistema administrativo local.
v Diretório de contatos corporativos do SmartCloud iNotes
O diretório do SmartCloud iNotes contém todas as entradas corporativas de pessoa e de grupo a serem
usadas com o SmartCloud iNotes; ele é geralmente criado a partir de, e sincronizado com, o diretório
corporativo.
v Arquivo de mudanças de integração de diretório
Um arquivo de mudanças de integração de diretório é um arquivo de texto LDIF (Formato de Troca de
Dados LDAP) criado pelo cliente. Ele contém adições, atualizações e exclusões para cada pessoa ou
grupo no diretório ou diretórios corporativos. O conteúdo e o nome do arquivo devem aderir às
especificações requeridas.
Você faz upload dos arquivos de mudanças no servidor de integração, usando FTP seguro, para
integração com o IBM SmartCloud for Social Business. Mudanças subsequentes nas informações em
seu diretório corporativo do cliente local podem ser gravadas periodicamente para criar novos arquivos
de mudanças em uma base automatizada, por meio da ativação de tarefa ou por meio de um agente
customizado, usando as convenções de nomenclatura e de conteúdo do arquivo requeridas.
Quando o servidor de integração processa um arquivo de mudanças, ele gera um arquivo de relatório
associado.
Para obter informações adicionais sobre os arquivos de mudanças de integração de diretório, consulte
“Criando Arquivos de Mudanças de Integração de Diretório” na página 65.
64
v Site de FTP
Um mecanismo de transferência FTP permite fazer upload de arquivos de mudanças no servidor de
integração (por meio do site de integração e migração baseado em nuvem) sobre um canal
criptografado por SSL autenticado. Também permite fazer o download dos arquivos de relatório e de
rastreio associados a partir do servidor de integração por meio do site de integração e migração.
Nota: É possível designar um ou mais usuários que tenham permissão para fazer upload e download
dos arquivos. Uma pasta particular é dedicada à sua conta. Apenas usuários designados podem acessar
essa pasta.
v Site de integração e migração
O site de integração e migração funciona com o servidor de integração e o site FTP durante o upload
dos arquivos de mudança e o download de seus arquivos de relatório e de rastreio associados.
v Servidor de integração
O servidor de integração lê cada arquivo de mudanças transferido por upload do site FTP e envia as
operações de mudanças codificadas para a conta de sua organização.
v Business Support System
O Business Support System (BSS) é o componente central usado para definir e gerenciar a conta de sua
organização.
“Criando Arquivos de Mudanças de Integração de Diretório”
Um arquivo de mudanças de integração de diretório é um arquivo de texto LDIF criado pelo cliente. Ele
contém informações de inclusão, atualização e exclusão de cada pessoa ou grupo no diretório ou
diretórios corporativos de sua organização para fazer upload para o diretório de contatos corporativos do
IBM SmartCloud iNotes.
Criando Arquivos de Mudanças de Integração de Diretório
Usando o servidor de integração e os arquivos de mudanças de integração de diretório, é possível fazer
upload de alguns ou todos os usuários e grupos em seu diretório corporativo no diretório de contatos
corporativos do SmartCloud iNotes quantas vezes forem necessárias.
Os formatos de nome e de conteúdo do arquivo de mudanças de integração de diretório necessários são
descritos aqui.
65
Para exemplos, consulte “Exemplos: Arquivos de Mudanças de Integração de Diretório” na página 68.
Convenção de Nomenclatura do Arquivo de Mudanças de Integração de Diretório
Os arquivos de mudanças de integração de diretório devem ser nomeados corretamente para serem
reconhecidos e processados. Use a convenção de nomenclatura a seguir ao criar um arquivo de mudança
de integração de diretório:
customerId_sourceId_di_seqnum.ldif
Tabela 5. Convenção de Nomenclatura do Arquivo de Mudanças de Integração de Diretório
Tipo de entrada de nome do arquivo
customerId
Especifica o identificador numérico interno designado ao cliente.
Seu ID de cliente está localizado na seção Conta da Empresa: Configurações da interface com o usuário de Administração. Use o
valor designado à sua conta de cliente específica para o valor de customerId.
sourceId
Especifica o nome opcional da origem autorizada da(s) mudança(s).
A parte sourceId do nome do arquivo de mudanças poderá ficar em branco se houver apenas uma origem de informações de
identidade dentro da organização.
tipo
O tipo do arquivo de integração de diretório é DI.
seqNum
Especifica o número de sequência usado para ordenar o processamento de arquivos; o valor deve ser um valor de número inteiro
entre 0 e 9223372036854775807. O valor não deve ser menor que aquele do último arquivo processado.
Se o último número de sequência foi 9223372036854775807 e tiver sido processado, com êxito ou com uma falha, o próximo arquivo
de provisionamento pode ter um número de sequência de 1 ou acima. Isso permite que você reconfigure o último número de
sequência armazenado no servidor.
O tempo da época UNIX é o formato recomendado. Use o registro de data e hora do UNIX para a parte seqNum do nome do
arquivo. Consulte http://www.epochconverter.com para obter detalhes.
Os números de sequência são relativos aos valores customerId e sourceId. Isso permite a independência de máquina e região.
ext
Especifica a extensão do arquivo que indica o tipo de codificação de dados; as opções são as seguintes:
v .ldif - codificação LDIF; deve ser especificada para arquivos de mudança de integração
v .csv - codificação de valores separados por vírgula; deve ser especificada para arquivos de mudanças de fornecimento de usuário
Os nomes dos arquivos de mudanças de integração de diretório de exemplo são os seguintes:
v 30020506_ActiveDirectory_DI_1260226223.LDIF
v 30020506_DI_1260226223.ldif
Em ambos os exemplos, o nome da organização é representado pela sequência de caracteres 30020506, os
arquivos são arquivos de mudanças de integração de diretório, o número de sequência é 1260226223 e o
arquivo é designado como um tipo de arquivo LDIF. O primeiro exemplo usa o ID de origem de
autorização opcional.
Nota: Como os valores sourceId e seqNum são controlados por organização, a sincronização de data e hora
entre você e a IBM não é necessária.
Operações do Arquivo de Mudanças de Integração de Diretório
As operações suportadas do arquivo de mudança de integração de diretório são como seguem. Consulte
as Tabelas 3 e 4 e “Exemplos: Arquivos de Mudanças de Integração de Diretório” na página 68 para
sintaxe e exemplos.
Nota: Usando sua página de conta da organização, é possível especificar opcionalmente que os Termos
de Uso do IBM SmartCloud for Social Business sejam aceitos automaticamente para todos os usuários.
Nota: Para arquivos de mudanças de integração de diretório, o servidor de integração não processa tipos
de operação em que o nome do tipo de operação contém letra maiúscula. Por exemplo, as entradas do
tipo de operação Incluir são ignoradas, mas as entradas incluir são processadas.
66
Tabela 6. Tipos de Operação do Arquivo de Mudanças
Tipos de operação do arquivo de
mudanças
Descrição
add
Cria uma nova entrada para o registro de pessoa especificado no diretório de contatos corporativos do SmartCloud iNotes.
modify
Atualiza uma entrada para o registro de pessoa especificado no diretório de contatos corporativos do SmartCloud iNotes. As
operações de modificação podem excluir, substituir, incluir e assim por diante.
delete
Exclui uma entrada para o registro de pessoa especificado do diretório de contatos corporativos do SmartCloud iNotes.
modrdn ou moddn
Renomeia o grupo correspondente de acordo com o atributo newrdn.
Campos de Dados para Entradas de Pessoa e Grupo
A tabela a seguir mostra como as entradas de pessoa no arquivo de mudança devem ser especificadas em
termos do esquema inetOrgPerson. Os atributos suportados que não possuem um inetOrgPerson
equivalente são mostrados em itálico.
O atributo de correio deve ser especificado em operações de Inclusão.
Nota: A validação da sintaxe não é executada em valores de atributos de correio.
Nota: O comprimento máximo de caracteres para todos atributos é 255.
Nota: Todos os formatos de tipo de dados são Sequência a menos que indicado o contrário.
Tabela 7. Campos de Dados para Entradas de Pessoa de Integração de Diretório
LDAP inetOrgPerson ou outro atributo
Rótulo de Campo na UI de diretório de Contatos Corporativos do iNotes
DN
ND
givenName
Primeira linha no cabeçalho
middleName
não exibido
sn
primeira linha no cabeçalho
title
segunda linha no cabeçalho
o
terceira linha no cabeçalho
nickName
não exibido
displayName
não exibido
birthday
não exibido
departmentNumber
não exibido
descrição
Notas
– Endereços de e-mail –
mail
e-mails (Comercial)
homeMail
e-mails (Residencial)
– Números de Telefone –
telephoneNumber
Telefone (Comercial)
homePhone
Telefone (Residencial)
pager
Telefone (Pager)
mobile
Telefone
facsimileTelephoneNumber
Telefone (Fax)
– Endereço residencial –
homeStreetAddress
Endereço (Residencial)
homeCity
homeState
homePostalCode
homeCountry
– Endereço Comercial –
street
Endereço (Comercial)
l
st
postalCode
c
– URLS –
labeledURL
não exibido
homeURL
não exibido
67
Tabela 8. Campos de Dados para Entradas de Grupo de Arquivo de Mudanças de Integração de Diretório
Atributo LDAP de GroupOfNames ou outro
atributo
Rótulo de Campo na UI de diretório
de Contatos Corporativos do iNotes
Codificação JSON da API Rest de Contatos
DN
não exibido
“source”:value
cn
primeira linha no cabeçalho
“lastName”:value
descrição
Notas
notes”:[value1,...,value2]
o
segunda linha no cabeçalho
companyName”:value
mail
e-mails (Comercial)
nickName
não exibido
“emails”:[ {
“value”:value,
“type”:”work”,
“primary”: true} ]
“nickName”:[value1,...,value2]
“Exemplos: Arquivos de Mudanças de Integração de Diretório”
Uma vez familiarizado com as especificações necessárias de nomenclatura de arquivo e atributo, é
possível criar arquivos de mudanças de integração de diretório para fazer upload de informações de seu
diretório corporativo para o diretório de contatos corporativos do IBM SmartCloud iNotes.
Exemplos: Arquivos de Mudanças de Integração de Diretório
Uma vez familiarizado com as especificações necessárias de nomenclatura de arquivo e atributo, é
possível criar arquivos de mudanças de integração de diretório para fazer upload de informações de seu
diretório corporativo para o diretório de contatos corporativos do IBM SmartCloud iNotes.
Revise “Criando Arquivos de Mudanças de Integração de Diretório” na página 65 antes de continuar.
v Incluir uma nova pessoa no diretório de contatos corporativos.
Se este for um grupo objectClass, use groupOfNames em vez de inetOrgPerson. Os atributos
displayName e mail são obrigatórios, todos os outros são opcionais.
DN: cn=Joe Smith,ou=Desenvolvimento,o=Acme
changeType: add
objectClass: inetOrgPerson
displayName: Joe Smith
mail: [email protected]
givenName: Joe
sn: Smith
telephoneNumber: 999 123-9876
v Modificar as informações de contato de um usuário existente
Excluir um número de página e incluir um número de telefone celular.
DN: cn=Joe Smith,ou=Contabilidade,o=Acme
changeType: modify
delete: pager
replace: mobile
mobile: 123 456-7890
Incluir um número de telefone.
DN: cn=Joe Smith,ou=Marketing,o=Acme
changeType: modify
add: telephoneNumber
Substituir qualquer título existente por um novo título.
68
DN: cn=Joe Smith,ou=Vendas,o=Acme
changeType: modify
replace: title
title: Vice-presidente Sênior
v Excluir um usuário.
Remova um usuário que não está mais na organização.
DN: cn=Joe Smith,ou=Controle de Qualidade,o=Acme
changeType: delete
v Substituir o nome de um usuário.
dn: cn=Marsha Smith,ou=Desenvolvimento de Produto,o=Acme
changetype: modrdn
newrdn: Marsha Jones
newsuperior: ou=Marketing, o=Acme
Exemplo de uma Nova Entrada Totalmente Preenchida
Uma amostra de usuário totalmente preenchida é mostrada a seguir.
dn: cn=Joe Smith,ou=Usuários,dc=Acme,dc=com
changetype: add
objectClass: inetOrgPerson
givenName: Joseph
middleName: Michael
sn: Smith
title: Especialista de Suporte Técnico
o: TestCustomer
nickName: jms
displayName: Joseph M Smith
birthday: 1963-07-19
departmentNumber: Departamento ZZZ
description: Membro da equipe de suporte ABX
mail: [email protected]
homeMail: [email protected]
homePhone: 456 123-7890
pager: 000 111-2222
mobile: 111 222-3333
facsimiletelephonenumber: 222 333-4444
homeStreetAddress: 111 Boston St
homeCity: Boston
homeState: MA
homePostalCode: 12134
homeCountry: EUA
street: 550 King St
l: Littleton
st: MA
postalCode: 01460
c:US
labeledURI: http://www.lotuslive.com
homeUrl: http://www.abx789.com
69
“Criando Arquivos de Mudanças de Integração de Diretório” na página 65
“Processando Arquivos de Mudanças”
Criando um Agente para Capturar o Conteúdo do Arquivo de
Mudanças
Fazer upload dos arquivos de mudanças para o servidor de integração permite incluir facilmente o
conteúdo de identidade do usuário. É possível criar arquivos de mudanças em uma base periódica
usando agentes que são executados em seu ambiente administrativo em instalações locais.
Considere o que segue ao criar agentes para criar e fazer upload de arquivos de mudança:
v Onde o agente deve procurar dados
v Em que campos o agente deve procurar
v Como especificar o nome do arquivo e o layout do formato que o agente deve usar para criar e
preencher o arquivo de mudança
v Em qual intervalo o agente deve procurar dados
v Como o agente deve determinar quais informações foram alteradas desde sua última procura
v Em qual site FTP e pasta o agente deve colocar o arquivo de mudança recém-alterado
Processando Arquivos de Mudanças
Os tipos de arquivos de mudanças suportados são os seguintes e estão listados na ordem em que são
processados:
v Integração do diretório
70
v Fornecimento do usuário
O processo de upload do conteúdo do arquivo de mudanças por meio do servidor de integração requer
que você execute o seguinte:
1. Solicite e obtenha a ativação do servidor de integração por meio do Atendimento ao Cliente do IBM
SmartCloud for Social Business.
2. Crie um agente ou script que obtém informações de conteúdo novas e alteradas de seu sistema
administrativo local e cria um novo arquivo de mudanças que captura essas informações. O nome do
arquivo e a formatação do conteúdo do arquivo de mudanças são críticos.
3. Para o fornecimento de usuário, determine se você deseja fazer este fornecimento como parte de uma
assinatura em pacote configurável ou como assinantes simples de lugar.
4. Determine com que frequência, e a partir de onde, o agente deve buscar informações de conteúdo
novas e alteradas em seu ambiente local.
5. Assegure-se de que o agente coloque os arquivos de mudanças que ele cria durante esse processo no
site FTP designado no diretório correto.
6. Determine quem na sua organização será a identidade autorizada a colocar arquivos no site FTP e
obter os arquivos de resultados correspondentes gerados.
7. Conforme assegurado pelos arquivos de relatório e rastreio, corrija quaisquer erros relatados,
renomeie o arquivo de mudanças para facilitar a numeração de sequência correta e mova o arquivo
para o diretório do site FTP para fazer upload para reprocessamento.
Também requer que o atendimento ao cliente faça o seguinte:
1. Responda à sua solicitação de ativação do servidor de integração com sua própria solicitação de
dados da conta necessários, como seu nome e ID da organização.
2. Permita que sua organização use o servidor de integração.
3. Entre em contato com você quando a ativação do servidor de integração estiver concluída e lhe
forneça quaisquer informações específicas da organização, como endereço ou nome do site FTP.
Transferência de Arquivos FTP de Arquivos de Mudanças e Arquivos
de Resultados
O site de integração e migração é um serviço intermediário que ajuda a facilitar a transferência de dados
entre o seu site FTP local e o servidor de integração. O serviço FTP é configurado conforme a seguir:
v Host – ftp.na.collabserv.com ou ftp.ap.collabserv.com, dependendo do seu ambiente de hosting.
v Porta – 990
v Modo SSL – implícito
v Cifra SSL -- Suporta conjuntos de cifra de criptografia alta do OpenSSL e m operações de FTP. O
conjunto de cifra de criptografia alta é compatível com os clientes FTP populares como o FileZilla
versões 3.5.2 e 3.5.3.
Nota: Se sua organização tiver um firewall controlando o fluxo de tráfego que entra e sai de sua rede,
você deverá configurar o firewall para abrir a porta 990, bem como o intervalo de portas de 60000 a
61000 (para o modo Passivo de FTP) para permitir que os dados atinjam o site de integração e migração
necessário.
71
Também é possível usar o site de integração e migração para fazer o download de arquivos de diário;
consulte Visão Geração do Serviço de Diário na seção Diário da documentação do produto para obter
detalhes.
O servidor FTP usa software antivírus para detectar e colocar em quarentena os arquivos infectados.
As informações de resumo para diversos arquivos de mudanças podem residir em um único arquivo de
relatório. Se todas as operações em um arquivo de mudanças foram executadas com êxito, o processo
moverá o arquivo de relatório para a pasta _processed. Se ocorrerem um ou mais erros, ele moverá o
arquivo de mudanças para a pasta _error.
O processo gera um arquivo de rastreio separado para corresponder a cada arquivo de mudanças
transferido por upload processado, permitindo que você execute uma validação programática no status
de cada operação no arquivo.
Os arquivos de rastreio são movidos para a mesma pasta _processed ou _error, conforme seu arquivo de
mudanças correspondente.
É possível excluir arquivos dos diretórios _error, _processed e _report no servidor FTP.
Nota: É possível excluir arquivos de mudança, rastreio e de relatório que você não precisa mais do seu
site de integração e migração. Todos os arquivos nas pastas _report, _error, e _processed da sua
organização com uma data de criação com mais de 30 dias são automaticamente excluídos.
ativação.
Balanceamento de Carga e Limitações de Processamento
Quando o servidor de integração processa um arquivo de mudanças, primeiro ele conta o número de
entradas. Ele não processará o arquivo se isso excederá os limites do arquivo. Se o processamento
excederá os limites por hora ou diário, o arquivo será processado no próximo ciclo. O servidor de
integração processa todos os arquivos de mudanças de uma organização até atingir o limite por hora ou
diário para uma única organização e, depois, muda para a próxima organização na fila. Existem os
limites a seguir:
v 750 operações de mudança por hora para arquivos de mudanças de fornecimento de usuário
v 10000 operações de mudança por dia
v 200 operações por arquivo de mudanças
72
Se o máximo por hora for atingido, os arquivos da organização serão ignorados até a próxima hora. Se o
máximo por dia for atingido, os arquivos da organização serão ignorados até o próximo dia e uma
entrada será incluída no arquivo de relatório. Um arquivo de rastreio será criado se um erro for
encontrado.
Se a contagem de entradas do arquivo for a mesma ou maior que o limite diário, o arquivo será movido
para o diretório _error e uma entrada será incluída no arquivo de relatório.
Se as entradas de um único arquivo excederem o limite de 200 operações, o arquivo será movido para o
diretório _error e uma entrada será incluída no arquivo de relatório.
Se um arquivo for ignorado, o número de sequência não será atualizado. Se o arquivo for processado mas
ocorrer um erro, o número de sequência será atualizado.
“Arquivos de Relatório do Servidor de Integração”
Arquivos de Relatório do Servidor de Integração
Os arquivos de relatório contêm um resumo das operações bem sucedidas e detalhes das operações para
quais foram encontrados erros. É possível usar um arquivo de relatório para executar o seguinte:
v Verifique se as operações desejadas ocorreram.
v Descubra e corrija os problemas.
v Forneça informações de resolução de problemas.
Relatórios são gerados no diretório _report.
Os arquivos de relatório e de rastreio fornecem valores de código de resultado para ajudar na
determinação e validação dos resultados do processamento.
Os nomes dos arquivos de relatório são gerados com base na data e hora em que o processamento
iniciou. Os nomes dos arquivos de relatório de amostra são os seguintes:
_report\LLIS_Report_20120820_121003.txt
É possível excluir arquivos de relatório que você não precisa mais. Todos os arquivos nas pastas _report,
_error, e _processed da sua organização com uma data de criação com mais de 30 dias são
automaticamente excluídos.
Segue o conteúdo do arquivo de relatório de amostra para um arquivo de mudanças de fornecimento
mostrando uma combinação de operações bem-sucedidas e com falha:
8/2/12 23h32m - *** Processando arquivo: llis/acme/foo
8/2/12 23h32m - ERRO: O formato do nome do arquivo não é válido.
8/2/12 23h32m - *** Processando arquivo: llis/acme/10049989_sequence
8/2/12 23h32m - ERRO: O formato do nome do arquivo não é válido.
73
8/2/12 23h32m - *** Processando arquivo: llis/acme/20049989_PRV_00000000.csv
8/2/12 23h32m - ERRO: Ocorreu uma falha ao processar a entrada nº1 do CSV.
A mensagem de erro é a seguinte: com.abx.bss.shim.exceptions.BadRequestException:
O endereço de e-mail já existe.
8/2/12 23h32m Entradas CSV lidas: 1; entradas BSS gravadas: 0;
Erros de leitura de CSV: 0;
Erros de gravação de BSS: 1
8/2/12 23h32m - Entradas CSV lidas: 3; entradas BSS gravadas: 3; Nenhum erro!
8/2/12 23h33m - ERRO: Ocorreu uma falha ao processar a entrada nº1 do CSV.
A mensagem de erro é a seguinte:
ERRO: Não é possível revogar, o usuário não retém a assinatura.
8/2/12 23h33m Entradas CSV lidas: 1; entradas BSS gravadas: 0;
Erros de leitura de CSV: 0;
Erros de gravação de BSS: 1
Se um erro ocorrer durante o processamento, o arquivo de mudança será movido para o subdiretório
_err para evitar seu reprocessamento, o erro será registrado em um relatório e arquivo de rastreio
associados e o processamento de arquivos sequencialmente numerados continuará.
Usando o arquivo de relatório e de rastreio, é possível determinar e corrigir o problema e fazer upload
do arquivo de mudança para reprocessamento.
Nota: Altere a parte de data e hora do nome do arquivo de mudança para que ele possa ser reprocessado
sequencialmente.
Para todas as definições de código de resultado, consulte “Arquivos de Relatório do Servidor de
Integração” na página 73.
“Arquivos de Rastreio do Servidor de Integração”
“Valores de Código de Erro para Arquivos de Mudanças Processados” na página 81
Arquivos de Rastreio do Servidor de Integração
Os arquivos de rastreio contêm informações detalhadas do status para cada operação do arquivo de
mudanças processada.
Arquivos de rastreio são criados no mesmo subdiretório _processed ou _error no qual o arquivo de
mudança correspondente reside. Cada nome de arquivo de rastreio corresponde a seu nome de arquivo
de mudança correspondente seguido por _trace, por exemplo 20049989_PRV_00000000_trace.csv.
Nota: É possível excluir arquivos de rastreio que você não precisa mais. Todos os arquivos nas pastas
_report, _error, e _processed da sua organização com uma data de criação com mais de 30 dias são
automaticamente excluídos.
74
Consulte “Arquivos de Relatório do Servidor de Integração” na página 73 para obter uma lista de todos
os códigos de resultado disponíveis.
Arquivos de Rastreio de Fornecimento de Usuário
Os arquivos de rastreio de fornecimento de usuário aderem ao seguinte formato:
entryNum,lineNum,resultCode,”original_line_from_change_file”
v
v
v
v
entryNum é a contagem sequencial da entrada de mudança.
lineNum é o número da linha em que a entrada de mudança começa.
resultCode é o código de resultado em número inteiro gerado para a entrada de mudança.
original_line_from_change_file é a linha que foi processada.
O conteúdo do arquivo de rastreio de amostra para um arquivo de mudanças de fornecimento de usuário
é mostrado a seguir. O código de resultado zero nas duas primeiras linhas indica sucesso de
processamento. A linha da entrada 99 indica uma linha que não foi possível processar.
entryNum,lineNum,resultCode,emailAddress,action,subscriptionId,givenName,familyName,language
1,5,0,[email protected],Add,85180,Joe,Smith,en_US
2,7,0,[email protected],Add,,Randi,Factor,en_US
...
99,97,1,bad input line
Valores de Fuso Horário para Arquivos de Mudanças
Os valores do campo Fuso Horário disponíveis para os arquivos de mudanças do servidor de integração
são conforme listados.
Os nomes de fuso horário são definidos no banco de dados tz, que também é chamado de banco de
dados zoneinfo ou banco de dados Olson. Consulte Lista de Fusos Horários do Banco de Dados tz (abre
em uma nova janela) para obter informações de referência.
Os valores de fuso horário do usuário a seguir estão disponíveis.
Pacífico/Apia (GMT-11:00) Horário Padrão de Samoa (Apia)
Pacífico/Pago_Pago (GMT-11:00) Horário Padrão de Samoa (Pago Pago)
Pacífico/Honolulu (GMT-10:00) Horário Padrão de Havaí-Aleutian
América/Adak (GMT-09:00) Estados Unidos (Adak)
América/Anchorage (GMT-08:00) Horário de Verão do Alasca
América/Ensenada (GMT-08:00) Horário Padrão do Pacífico
América/Mazatlán (GMT-07:00) Horário Padrão das Montanhas (Mazatlán)
América/Phoenix (GMT-07:00) Horário Padrão das Montanhas (Phoenix)
América/Los_Angeles (GMT-07:00) Horário de Verão do Pacífico (Los Angeles)
América/Vancouver (GMT-07:00) Horário de Verão do Pacífico (Vancouver)
América/Whitehorse (GMT-07:00) Horário de Verão do Pacífico (Whitehorse)
América/Mexico_City (GMT-06:00) Horário Padrão Central (Cidade do México)
América/Regina (GMT-06:00) Horário Padrão Central (Regina)
Chile/EasterIsland (GMT-06:00) Horário da Ilha de Páscoa
América/Denver (GMT-06:00) Horário de Verão das Montanhas (Denver)
América/Edmonton (GMT-06:00) Horário de Verão das Montanhas (Edmonton)
América/Chicago (GMT-05:00) Horário de Verão Central (Chicago)
América/Indiana/Knox (GMT-05:00) Horário de Verão Central (Knox)
América/Winnipeg (GMT-05:00) Horário de Verão Central (Winnipeg)
América/Atikokan (GMT-05:00) Horário Padrão do Leste (Atikokan)
América/Jamaica (GMT-05:00) Horário Padrão do Leste (Jamaica)
América/Manaus (GMT-04:00) Horário do Amazonas (Manaus)
América/Porto_Acre (GMT-04:00) Horário do Amazonas (Porto Acre)
América/Guadalupe (GMT-04:00) Horário Padrão do Atlântico (Guadalupe)
América/Puerto_Rico (GMT-04:00) Horário Padrão do Atlântico (Porto Rico)
América/St_Thomas (GMT-04:00) Horário Padrão do Atlântico (St Thomas)
América/Santiago (GMT-04:00) Horário do Chile
América/Havana (GMT-04:00) Horário de Verão de Cuba
América/Detroit (GMT-04:00) Horário de Verão do Leste (Detroit)
América/Fort_Wayne (GMT-04:00) Horário de Verão do Leste (Fort Wayne)
América/Kentucky/Louisville (GMT-04:00) Horário de Verão do Leste (Louisville)
75
América/New_York (GMT-04:00) Horário de Verão do Leste (Nova York)
América/Toronto (GMT-04:00) Horário de Verão do Leste (Toronto)
América/Argentina/Buenos_Aires (GMT-03:00) Horário da Argentina (Buenos Aires)
América/Argentina/Córdoba (GMT-03:00) Horário da Argentina (Córdoba)
América/Argentina/Catamarca (GMT-03:00) Horário da Argentina (Catamarca)
América/Argentina/Jujuy (GMT-03:00) Horário da Argentina (Jujuy)
América/Argentina/Mendoza (GMT-03:00) Horário da Argentina (Mendoza)
América/Halifax (GMT-03:00) Horário de Verão do Atlântico
América/Sao_Paulo (GMT-03:00) Horário de Brasília
América/St_Johns (GMT-02:30) Horário de Verão de Terra Nova
América/Noronha (GMT-02:00) Horário de Fernando de Noronha
Europa/Belfast (GMT+00:00) Horário de Greenwich (Belfast)
África/Bamako (GMT+00:00) Horário de Greenwich (Bamako)
Atlântico/Reykjavik (GMT+00:00) Horário de Greenwich (Reykjavik)
Europa/Dublin (GMT+00:00) Horário de Greenwich (Dublin)
Atlântico/Faroé (GMT+00:00) Horário da Europa Ocidental (Faroé)
Europa/Lisboa (GMT+00:00) Horário da Europa Ocidental (Lisboa)
Ártico/Longyearbyen (GMT+01:00) Horário da Europa Central (Longyearbyen)
Europa/Belgrado (GMT+01:00) Horário da Europa Central (Belgrado)
Europa/Bratislava (GMT+01:00) Horário da Europa Central (Bratislava)
Europa/Paris (GMT+01:00) Horário da Europa Central (Paris)
Europa/Roma (GMT+01:00) Horário da Europa Central (Roma)
Europa/Varsóvia (GMT+01:00) Horário da Europa Central (Varsóvia)
África/Harare (GMT+02:00) Horário da África Central
África/Cairo (GMT+02:00) Horário da Europa Oriental (Cairo)
Ásia/Istambul (GMT+02:00) Horário da Europa Oriental (Istambul)
Ásia/Nicósia (GMT+02:00) Horário da Europa Oriental (Nicósia)
Europa/Chisinau (GMT+02:00) Horário da Europa Oriental (Chisinau)
Europa/Helsinque (GMT+02:00) Horário da Europa Oriental (Helsinque)
África/Trípoli (GMT+02:00) Horário da Europa Oriental (Trípoli)
Ásia/Jerusalém (GMT+02:00) Horário Padrão de Israel
África/Addis_Ababa (GMT+03:00) Horário da África Oriental (Adis Abeba)
África/Asmara (GMT+03:00) Horário da África Oriental (Asmara)
Europa/Moscou (GMT+04:00) Horário Padrão de Moscou
Ásia/Erevan (GMT+04:00) Horário da Armênia
Ásia/Teerã (GMT+04:30) Horário de Verão do Irã
Ásia/Carachi (GMT+05:00) Horário do Paquistão
Ásia/Ashgabat (GMT+05:00) Horário do Turcomenistão
Ásia/Calcutá
(GMT+05:30) Horário Padrão da Índia
Ásia/Catmandu
(GMT+05:45) Horário de Nepal
Ásia/Thimbu
(GMT+06:00) Horário de Butão
Ásia/Daca
(GMT+07:00) Horário de Versão de Bangladesh
Ásia/Ho_Chi_Minh
(GMT+07:00) Horário da Indochina
Austrália/Perth
(GMT+08:00) Horário Padrão Ocidental da Austrália
Ásia/Makassar (GMT+08:00) Horário da Indonésia Central
Ásia/Chongqing
(GMT+08:00) Horário Padrão da China (Chongqing)
Ásia/Macao
(GMT+08:00) Horário Padrão da China (Macao)
Ásia/Shanghai
(GMT+08:00) Horário Padrão da China (Shanghai)
Ásia/Hong_Kong
(GMT+08:00) Horário de Hong Kong
Ásia/Singapura
(GMT+08:00) Horário Padrão de Singapura
Ásia/Taipei
(GMT+08:00) Horário Padrão de Taipei
Ásia/Ulaanbaatar
(GMT+08:00) Horário de Ulan Bator
Ásia/Tóquio
(GMT+09:00) Horário Padrão do Japão
Ásia/Seul
(GMT+09:00) Horário Padrão da Coreia
Austrália/Darwin
(GMT+09:30) Horário Padrão Central da Austrália
Austrália/Brisbane (GMT+10:00) Horário Padrão Oriental da Austrália
Pacífico/Truk
(GMT+10:00) Horário de Truk
Pacifico/Chuuk
(GMT+10:00) Horário de Chuuk
América/Curaçao
(GMT-04:00)Horário Padrão do Atlantico (Curaçao)
Pacifico/Pohnpei
(GMT+11:00)Horário de Ponape
Austrália/Adelaide (GMT+10:30) Horário de Verão Central da Austrália (Adelaide)
Austrália/Broken_Hill (GMT+10:30) Horário de Verão Central da Austrália (Broken Hill)
Austrália/ACT
(GMT+11:00) Horário de Verão Oriental da Austrália (ACT)
Austrália/Hobart
(GMT+11:00) Horário de Verão Oriental da Austrália (Hobart)
Austrália/Melbourne (GMT+11:00) Horário de Verão Oriental da Austrália (Melbourne)
Austrália/LHI
(GMT+11:00) Horário de Verão de Lord Howe
Pacífico/Guadalcanal (GMT+11:00) Horário das Ilhas Salomão
Pacífico/Kwajalein (GMT+12:00) Horário das Ilhas Marshall
Antártida/McMurdo (GMT+13:00) Horário de Verão da Nova Zelândia (McMurdo)
Pacífico/Auckland (GMT+13:00) Horário de Verão da Nova Zelândia (Auckland)
Pacífico/Chatham
(GMT+13:45) Horário de Verão de Chatham
76
Valores de Idioma e País para Arquivos de Mudanças
Os valores dos campos Idioma e País disponíveis para os arquivos de mudanças do servidor de
integração são listados.
Os seguintes valores do campo Idioma estão disponíveis:
ca_ES - Catalão
da_DK - Dinamarquês
de_DE - Alemão
en_US - Inglês
es_ES - Espanhol
fr_FR
el_GR
it_IT
nl_NL
no_NO
pl_PL
-
Francês
Grego
Italiano
Holandês
Norueguês
Polonês
pt_PT
pt_BR
ru_RU
fi_FI
sv_SE
th_TH
-
Português
Português do Brasil
Russo
Finlandês
Sueco
Tailandês
tr_TR
zh_CN
zh_TW
ja_JP
ko_KR
–
-
Turco
Chinês Simplificado
Chinês Tradicional
Japonês
Coreano
Os seguintes valores do campo País estão disponíveis:
AF AX AL DZ AS AD AO AI AQ AG -
AFEGANISTÃO
ILHAS.ALAND
ALBÂNIA
ARGÉLIA
SAMOA.AMERICANA
ANDORRA
ANGOLA
ANGUILA
ANTÁRTIDA
ANTÍGUA.E.BARBUDA
77
AR
AM
AW
AU
AT
AZ
BS
BH
BD
BB
BY
BE
BZ
BJ
BM
BT
BO
BA
BW
BV
BR
IO
BN
BG
BF
BI
KH
CM
CA
CV
KY
CF
TD
CL
CN
CX
CC
CO
KM
CG
CD
CK
CR
CI
HR
CY
CZ
DK
DJ
DM
DO
EC
EG
SV
GQ
ER
EE
ET
FK
FO
FJ
FI
FR
GF
PF
TF
GA
GM
GE
DE
GH
GI
78
-
ARGENTINA
ARMÊNIA
ARUBA
AUSTRÁLIA
ÁUSTRIA
AZERBAIJÃO
BAHAMAS
BAHREIN
BANGLADESH
BARBADOS
BIELORRÚSSIA
BÉLGICA
BELIZE
BENIN
BERMUDA
BUTÃO
BOLÍVIA
BÓSNIA.E.HERZEGOVINA
BOTSUANA
ILHA.BOUVET
BRASIL
TERRITÓRIO.BRITÂNICO.DO.OCEANO.ÍNDICO
BRUNEI.DARUSSALAM
BULGÁRIA
BURKINA.FASO
BURUNDI
CAMBOJA
CAMARÕES
CANADÁ
CABO.VERDE
ILHAS.CAIMÃO
REPÚBLICA.DA.ÁFRICA.CENTRAL
CHADE
CHILE
CHINA
ILHAS.CHRISTMAS
ILHAS.COCOS.(KEELING)
COLÔMBIA
COMORES
CONGO
REPÚBLICA.DEMOCRÁTICA.DO.CONGO
ILHAS.COOK
COSTA.RICA
COSTA.DO.MARFIM
CROÁCIA
CHIPRE
REPÚBLICA.TCHECA
DINAMARCA
DIJIBOUTI
DOMINICA
REPÚBLICA.DOMINICANA
EQUADOR
EGITO
EL.SALVADOR
GUINÉ.EQUATORIAL
ERITREIA
ESTÔNIA
ETIÓPIA
ILHAS.FALKLAND.(MALVINAS)
ILHAS.FAROÉ
FIJI
FINLÂNDIA
FRANÇA
GUIANA.FRANCESA
POLINÉSIA.FRANCESA
TERRITÓRIOS.DO.SUL.DA.FRANÇA
GABÃO
GÂMBIA
GEÓRGIA
ALEMANHA
GANA
GIBRALTAR
GR
GL
GD
GP
GU
GT
GG
GN
GW
GY
HT
HM
VA
HN
HK
HU
IS
IN
ID
IQ
IE
IM
IL
IT
JM
JP
JE
JO
KZ
KE
KI
KR
KW
KG
LA
LV
LB
LS
LR
LY
LI
LT
LU
MO
MK
MG
MW
MY
MV
ML
MT
MH
MQ
MR
MU
YT
MX
FM
MD
MC
MN
ME
MS
MA
MZ
NA
NR
NP
NL
AN
NC
NZ
-
GRÉCIA
GROENLÂNDIA
GRANADA
GUADALUPE
GUAM
GUATEMALA
GUERNSEY
GUINÉ
GUINÉ-BISSAU
GUIANA
HAITI
ILHA.HEARD.E.ILHAS.MCDONALD
CIDADE.DO.VATICANO
HONDURAS
HONG.KONG
HUNGRIA
ISLÂNDIA
ÍNDIA
INDONÉSIA
IRAQUE
IRLANDA
ILHA.DE.MAN
ISRAEL
ITÁLIA
JAMAICA
JAPÃO
JERSEY
JORDÃO
CAZAQUISTÃO
QUÊNIA
KIRIBATI
REPÚBLICA.DA.COREIA
KUWAIT
QUIRGUISTÃO
REPÚBLICA.DEMOCRÁTICA.POPULAR.DO.LAOS
LETÔNIA
LÍBANO
LESOTO
LIBÉRIA
REPÚBLICA.ARÁBICA.DA.LÍBIA
LIECHTENSTEIN
LITUÂNIA
LUXEMBURGO
MACAO
ANTIGA.REPÚBLICA.IUGOSLAVA.DA.MACEDÔNIA
MADAGASCAR
MALAUI
MALÁSIA
MALDIVAS
MALI
MALTA
ILHAS.MARSHALL
MARTINICA
MAURITÂNIA
MAURÍCIO
MAYOTTE
MÉXICO
ESTADOS.FEDERADOS.DA.MICRONÉSIA
REPÚBLICA.DA.MOLDÁVIA
MÔNACO
MONGÓLIA
MONTENEGRO
MONTSERRAT
MARROCOS
MOÇAMBIQUE
NAMÍBIA
NAURU
NEPAL
PAÍSES BAIXOS
ANTILHAS.HOLANDESAS
NOVA.CALEDÔNIA
NOVA.ZELÂNDIA
79
NI
NE
NG
NU
NF
MP
NO
OM
PK
PW
PS
PA
PG
PY
PE
PH
PN
PL
PT
PR
QA
RO
RU
RW
RE
BL
SH
KN
LC
MF
PM
VC
WS
SM
ST
SA
SN
RS
SC
SL
SG
SK
SI
SB
SO
ZA
GS
ES
LK
SR
SJ
SZ
SE
CH
TW
TJ
TZ
TH
TL
TG
TK
TO
TT
TN
TR
TM
TC
TV
UG
UA
AE
GB
80
-
NICARÁGUA
NIGER
NIGÉRIA
NIUE
ILHA.NORFOLK
ILHAS.MARIANAS.DO.NORTE
NORUEGA
OMÃ
PAQUISTÃO
PALAU
TERRITÓRIO.PALESTINO.OCUPADO
PANAMÁ
PAPUA.NOVA-GUINÉ
PARAGUAI
PERU
FILIPINAS
PITCAIRN
POLÔNIA
PORTUGAL
PORTO.RICO
QATAR
ROMÊNIA
FEDERAÇÃO.DA.RÚSSIA
RUANDA
REUNION
SÃO.BARTOLOMEU
SANTA.HELENA
SÃO.CRISTÓVÃO.E.NEVIS
SANTA.LÚCIA
SÃO.MARTINHO
SÃO.PEDRO.E.MIQUELÃO
SÃO.VICENTE.E.GRANADINAS
SAMOA
SAN.MARINO
SÃO.TOMÉ.E.PRÍNCIPE
ARÁBIA.SAUDITA
SENEGAL
SERVIA
SEYCHELLES
SERRA.LEOA
SINGAPURA
ESLOVÁQUIA
ESLOVÊNIA
ILHAS.SALOMÃO
SOMÁLIA
ÁFRICA.DO.SUL
GEÓRGIA.DO.SUL.E.ILHAS.SANDWICH.DO.SUL
ESPANHA
SRI.LANKA
SURINAME
SVALBARD.E.JAN.MAYEN
SUAZILÂNDIA
SUÉCIA
SUÍÇA
TAIWAN
TAJIQUISTÃO
REPÚBLICA.UNIDA.DA.TANZÂNIA
TAILÂNDIA
TIMOR-LESTE
TOGO
TOKELAU
TONGA
TRINIDAD.E.TOBAGO
TUNÍSIA
TURQUIA
TURCOMENISTÃO
ILHAS.TURKS.E.CAICOS
TUVALU
UGANDA
UCRÂNIA
EMIRADOS.ÁRABES.UNIDOS
REINO.UNIDO
US
UM
UY
UZ
VU
VE
VN
VG
VI
WF
EH
YE
ZM
ZW
-
ESTADOS.UNIDOS
ILHAS.MENORES.DISTANTES.DOS.EUA
URUGUAI
UZBEQUISTÃO
VANUATU
REPÚBLICA.BOLIVARIANA.DA.VENEZUELA
VIETNÃ
ILHAS.VIRGENS.BRITÂNICAS
ILHAS.VIRGENS.AMERICANAS
WALLIS.E.FUTUNA
SAARA.OCIDENTAL
IÊMEN
ZÂMBIA
ZIMBÁBUE
Valores de Código de Erro para Arquivos de Mudanças Processados
Os códigos de resultado relatados pelo servidor de integração em erros de arquivos de relatório e de
rastreio associados são listados e descritos aqui.
Nota: Se o servidor de integração encontrar mais de 100 erros de leitura ou 1000 erros de gravação ao
processar um único arquivo de mudanças, um erro será relatado nos arquivos de rastreio e de relatório
associados e o processamento desse arquivo de mudanças será parado na entrada em que o limite de
erros foi atingido.
Erros de leitura são problemas encontrados ao ler linhas de um arquivo de mudanças, como problemas
de formatação. Erros de gravação são problemas encontrados quando o servidor de integração tenta
processar entradas de arquivo de mudanças, como problemas de validação.
Tabela 9. Códigos de Erros Gerais
Código de
resultado
Sintaxe
Descrição
0
Success
A operação foi concluída com sucesso.
1
INVALID_FILENAME
O nome do arquivo de mudanças não está em conformidade com a
convenção requerida e o arquivo foi rejeitado.
Essa instrução é mostrada somente no arquivo de resultados.
81
Tabela 9. Códigos de Erros Gerais (continuação)
Código de
resultado
Sintaxe
Descrição
2
TYPE_DISABLED
O tipo de arquivo de mudanças especificado no nome do arquivo de
mudanças está atualmente desativado e o arquivo foi rejeitado.
3
INVALID_CUSTOMERID
4
INVALID_SEQNUM
1,52
MAX_READ_ERRORS_EXCEEDED
O número máximo de erros foi encontrado ao ler o arquivo de
mudanças e nenhuma entrada adicional foi processada.
1,83
MAX_WRITE_ERRORS_EXCEEDED
O número máximo de erros foi encontrado ao gravar entradas de
arquivo de mudanças e nenhuma entrada adicional foi processada.
7
ENTRY_ALREADY_EXISTS
A entrada de contato, grupo ou usuário especificada no arquivo de
mudanças para uma operação de Inclusão já existe.
8
ENTRY_NOT_FOUND
A entrada de contato, grupo ou usuário especificada no arquivo de
mudanças para uma operação de Modificação não existe.
9
FIELD_VALIDATION_ERROR
Um valor de campo ou atributo no arquivo de mudança não é válido
ou excede o comprimento máximo de caracteres.
10
INVALID_LDIF_SYNTAX
Uma entrada no arquivo de mudanças de integração (LDIF) contém
sintaxe inválida.
3,35
INVALID_DN
Uma entrada de DN foi omitida ou contém sintaxe inválida.
12
INVALID_OBJECTCLASS
O atributo objectClass em uma inclusão changeType não é suportado.
O customerId especificado no nome do arquivo não pertence ao
cliente que transferiu por upload o arquivo e o arquivo foi rejeitado.
O seqNum especificado no nome do arquivo de mudanças não é maior
que o seqNum do último arquivo de mudanças processado e o
arquivo de mudanças foi rejeitado.
Tabela 10. Códigos de Erro de Fornecimento de Usuário
Código de
resultado
Sintaxe
Descrição
1000
INVALID_CSV_SYNTAX
Uma entrada no arquivo de mudanças de fornecimento (arquivo CSV)
contém sintaxe inválida.
1001
CUSTOMER_HELD
O cliente especificado está em um estado HELD, durante o qual as
operações de fornecimento não são permitidas.
1002
CANNOT_REMOVE_COMPANY_CONTACT
O usuário especificado para uma operação de Remoção é o único
contato da empresa e sua identidade não pode ser removida.
1003
INVALID_SUBSCRIPTION
O subscriptionID ou tipo especificado não é válido ou não está
disponível para a empresa ou usuário especificado.
1004
MULTIPLE_MAIL_SEATS
A inclusão de diversos lugares de assinatura de correio usando um
arquivo de mudanças de fornecimento não é suportada.
1005
MULTIPLE_COLLAB_SEATS
A inclusão de diversos lugares de assinaturas de colaboração usando
um arquivo de mudanças de fornecimento não é suportada.
1006
INVALID_DOMAIN
O nome de domínio especificado no endereço de e-mail de um
usuário não é válido.
1007
SEATS_FILLED
A assinatura de destino especificada não tem lugares restantes
disponíveis.
1008
USER_WRITE_ERROR
Ocorreu um erro ao executar a operação solicitada para o usuário
nomeado.
1009
ERROR_CONNECTING_TO_BSS_RENAME
Ocorreu um erro ao tentar se conectar ao Serviço BSS_RENAME.
1010
ERROR_HTTPSTATUS_ERROR_SENDING_EMAIL_
TO_BSS_RENAME
Ocorreu um erro ao tentar se conectar ao Serviço BSS_RENAME.
1011
ERROR_GET_SUBSCRIBER_BY_COMPANYID_
AND_EMAIL_NOT_FOUND
Ocorreu um erro ao tentar obter um assinante por empresa e endereço
de e-mail.
1012
ERROR_CANNOT_REMOVE_COMPANY_CONTACT
Ocorreu um erro ao tentar remover um assinante porque não é
possível remover o contato da empresa.
1013
ERROR_RESOURCE_DIFF_COMPANY
Ocorreu um erro ao tentar modificar um assinante porque não é
possível designar recursos a contatos em uma empresa diferente.
1014
ERROR_RESOURCES_SUBSCRIBER_NOT_FOUND
Ocorreu um erro ao tentar modificar um assinante. O nome do
assinante AssignTo especificado não foi encontrado.
1015
ERROR_INVALID_ACTION
Uma ação inválida foi especificada no arquivo de mudanças de
fornecimento.
1016
ERROR_UNKNOWN_BSS_EXCEPTION
Ocorreu um erro de exceção do BSS (Business Subscriber Services)
desconhecido.
1017
ERROR_SUBSCRIPTIONTYPE_ERROR
Um subscriptionId inválido foi especificado na operação RevokeSeat.
1018
1019
82
ERROR_USER_DOESNT_HOLD_SUBSCRIPTION_
TO_REVOKE_OR_SIZE
ERROR_MAIL_REASSIGN_NOT_SUPPORTED
A solicitação para revogar ou alterar armazenamento extra para essa
assinatura falhou porque o usuário não retém essa assinatura.
A redesignação dos recursos de correio ainda não é suportada.
Tabela 10. Códigos de Erro de Fornecimento de Usuário (continuação)
Código de
resultado
Sintaxe
Descrição
1020
ERROR_COMPATIBLE_SUBSCRIPTION_NOT_FOUND
Um lugar/assinatura compatível não foi localizado durante uma
operação de mudança.
1021
ERROR_INVALID_TARGET_SUBSCRIPTION
Uma assinatura de destino inválido foi localizada durante uma
operação de mudança
1022
ERROR_TARGET_SUBSCRIPTION_FILLED
A assinatura de destino já foi preenchida e a operação não pode
alterar o lugar para essa assinatura.
1023
ERROR_TIME_ZONE_INVALID
Um valor de fuso horário inválido foi encontrado.
1024
ERROR_INVALID_SUBSCRIPTIONID2
O valor ou tipo de subscriptionID2 especificado é inválido ou não
pertence à empresa ou usuário.
1025
ERROR_CANT_ADD_TWO_MAIL_SUBSCRIPTION
A inclusão de duas assinaturas de correio não é suportada.
1026
ERROR_CANT_ADD_TWO_COLLAB_SUBSCRIPTION
A inclusão de duas assinaturas de colaboração não é suportada.
1027
ERROR_ONE_TIME_PASSWORD_ERROR
Uma senha descartável só pode ser especificada ao incluir um usuário
com uma assinatura de correio.
1028
ERROR_ALT_EMAIL_ON_ADD_ONLY_INOTES
O uso do atributo AltEmailAddress é válido apenas ao incluir um
assinante com uma assinatura do IBM SmartCloud iNotes.
1029
ERROR_ALT_EMAIL_INVALID_SYNTAX
O valor AltEmailAddress contém sintaxe inválida ou não foi
localizado.
1030
ERROR_MAIL_NO_PWD_OR_ALTEMAIL
Uma assinatura de correio foi solicitada, mas um altEmailAddress ou
uma senha descartável não foi localizada.
1031
ERROR_EMAIL_INVALID_SYNTAX
O valor EmailAddress contém sintaxe inválida ou não foi localizado.
1032
ERROR_FAILED_SPI_SERVICE
Ocorreu um erro get do serviço BSS SPI (Stateful Packet Inspections).
1033
ERROR_EMAIL_DOMAIN
Ocorreu um erro ao tentar validar o domínio de e-mail fornecido.
1034
ERROR_NOTES_USERNAME_VALIDATION
Ocorreu um erro ao tentar validar o nome de usuário fornecido.
1035
ERROR_EMAIL_ALREADY_EXISTS
O endereço de e-mail especificado já existe.
1036
ERROR_CUSTOMERID_INVALID_OR_NOT_FOUND
O valor de CustomerId não é válido ou não foi especificado.
1037
ERROR_ISV_SUBSCRIPTION_NOT_SUPPORTED
As assinaturas do ISV não são suportadas.
1038
ERROR_SPI_SERVICE_VALIDATION_ERROR
Ocorreu um erro de validação do Serviço SPI (Stateful Packet
Inspections).
1039
ERROR_EMAIL_VALIDATION_ERROR
Ocorreu um erro de validação de e-mail ou o endereço de e-mail já
existe.
1040
ERROR_ASSIGN_SEAT
Não é possível atribuir um lugar a um assinante.
1041
ERROR_INVALID_CHANGESTORAGE_SIZE
Um tamanho inválido foi especificado para o valor de armazenamento
de mudança.
1042
ERROR_SUBSCRIPTION_DOESNT_
SUPPORT_EXTRA_STORAGE
1043
ERROR_ASSIGNTO_SUBSCRIPTION_TYPE
1044
ERROR_NO_COMPATIBLE_EXTRA_STORAGE
Foi especificada uma assinatura que não suporta armazenamento
extra.
Não é possível designar o conteúdo ao assinante AssignTo porque o
tipo de assinatura não é compatível.
Nenhum armazenamento extra compatível foi localizado para uma
assinatura.
1045
ERROR_EXTRA_STORAGE_DEPLETED
O armazenamento extra para a assinatura especificada foi reduzido.
1046
ERROR_BSS_EMAIL_ADDRESS_ALREADY_EXISTS
O endereço de e-mail especificado já existe.
1047
ERROR_BSS_NO_SEATS_AVAILABLE
Nenhum lugar adicional está disponível.
1048
ERROR_RENAME_GENERAL
Ocorreu um erro durante uma operação de renomeação.
1049
INVALID_COUNTRY_CODE_FORMAT
O código do país especificado é inválido com base no formato; o
código do país deve ter o comprimento de duas letras. Consulte
“Valores de Idioma e País para Arquivos de Mudanças” na página 77
para obter códigos de país válidos.
1050
INVALID_COUNTRY_CODE
O valor do valor do código especificado não é válido. Consulte
“Valores de Idioma e País para Arquivos de Mudanças” na página 77
para obter códigos de país válidos.
1051
ERROR_JOBTITLE_LENGTH
O JobTitle excede o número máximo de 99 caracteres.
1052
ERROR_FAMILYNAME_LENGTH
O FamilyName excede o número máximo de 120 caracteres.
1053
ERROR_GIVENNAME_LENGTH
O GivenName excede o número máximo de 120 caracteres.
1054
ERROR_SUBSCRIBER_REMOVE_PENDING_ERROR
Uma operação AddSubscriber falhou porque outro assinante com o
mesmo endereço de e-mail está com a remoção pendente. A operação
AddSubscriber pode ser resubmetida depois da operação de remoção
pendente ter sido concluída.
1055
ERROR_NOTES_ATTRIBUTE_VALIDATION
1056
ERROR_FEDERATION_ONLY_PARTIAL
O valor especificado para o atributo FederationType não era válido.
Apenas empresas PARTIAL_FEDERATED podem ter usuários com
tipos de federação diferentes.
1057
ERROR_FEDERATION_INVALID_TYPE
O valor especificado para o atributo FederationType não era válido.
Apenas NON_FEDERATED, FEDERATED e MODIFIED_FEDERATED
são tipos de federação de usuário suportados.
O processo de validação de atributo falhou.
83
Tabela 10. Códigos de Erro de Fornecimento de Usuário (continuação)
Código de
resultado
Sintaxe
Descrição
1058
INVALID_SUPPRESS_INVITATION
O valor especificado para o atributo SuppressInvitation não era
válido.
1059
INOTES_FAILED_GET_DOMAINS
O terminal do iNotes falhou ao obter domínios do cliente.
1060
INOTES_NOT_ENABLED
A solicitação de fornecimento não pode ser concluída porque o iNotes
não está ativado.
1061
CANNOT_RESEND_TO_PENDING_ENTITLE
O convite não pode ser reenviado porque o assinante possui um lugar
no estado ENTITLE_PENDING.
1062
INVALID_PARAMETER
Um parâmetro inválido foi encontrado.
1063
SUBSCRIPTION_NOT_IN_ACTIVE_STATE
Uma assinatura especificada não pôde ser processada porque não
estava ativa.
1064
INVALID_SEAT
Um lugar inválido foi especificado.
1065
SEAT_REVOKE_FAILED
Uma operação RevokeSeat falhou.
1066
CHANGE_SEAT_FAILED
Uma operação ChangeSeat falhou.
1067
SUBSCRIBER_FETCH_FAILED
Ocorreu um erro de comunicação do BSS durante uma operação de
busca do assinante.
1068
CUSTOMER_FETCH_FAILED
Ocorreu um erro de comunicação do BSS durante uma operação de
busca do cliente.
1069
UNABLE_TO_VERIFY_EMAIL_DOMAIN
A verificação do domínio de email especificado falhou.
1070
SUBSCRIBER_ADD_FAILED
Uma operação AddSeat falhou em incluir o assinante especificado.
1071
SUBSCRIBER_ADD_FAILED_TO_SEND_EMAIL
Uma operação AddSeat falhou em enviar o email para o novo
assinante.
1072
SUBSCRIBER_SET_PASSWORD_FAILED
A entrada de senha do assinante não foi processada.
1073
ADD_SEAT_FAILED_DUPLICATE_SUBSCRIPTION
Uma operação AddSeat falhou; a conclusão da operação criaria uma
assinatura duplicada.
1074
ADD_SEAT_FAILED
Uma operação AddSeat falhou.
1075
PARAM_VALIDATION_TIME_ZONE_FAILED
A validação do fuso horário falhou.
1076
ERROR_UNKNOWN_BSS_UP_EXCEPTION
A validação do BSS falhou.
1077
ERROR_TIMEZONENOT_INIT
A inicialização do fuso horário falhou.
1078
ERROR_LANGUAGESETTINGSNOT_INIT
A inicialização da configuração de idioma falhou.
1079
RULE_USER_WITHOUT_SUBSCRIPTION_FAILED
Nenhuma assinatura foi especificada.
1080
RULE_ONLY_ONE_MAIL_SUB_PER_SUBSCRIBER
Somente uma assinatura de correio por assinante é permitida.
1081
RULE_ONLY_ONE_COLLAB_SUB_PER_SUBSCRIBER
Somente uma assinatura de colaboração por assinante é permitida.
1082
RULE_ONLY_MAIL_USER_CAN_HAVE_ONE_TIME_PASSWORD
Somente um assinante de correio pode ter uma senha descartável.
1083
RULE_ONLY_INOTES_USER_CAN_HAVE_ALT_EMAIL
Somente um usuário do iNotes pode ser designado a um endereço de
email alternativo.
1084
UNSUPPORTED_OPERATION_ADD_EXTRA_STORAGE
Uma solicitação para incluir armazenamento extra não é suportada.
1085
SUBSCRIBER_ADD_EXTRA_STORAGE_FAILED
Uma solicitação para incluir armazenamento extra falhou.
1086
NOTES_NOT_ENABLED
A solicitação de fornecimento não pode ser concluída porque o IBM
SmartCloud Notes não está ativado.
1087
CANNOT_RESEND_TO_PENDING_ENTITLE
O assinante tem um lugar em um estado ENTITLE_PENDING; o
convite não pode ser enviado até que o usuário seja autorizado.
1088
RULE_BUNDLE_EXCLUDES_ALACARTE_SUBSCRIPTIONS
Uma operação AssignSeat está tentando fornecer um usuário como
uma parte da assinatura empacotada, mas o usuário já foi fornecido
como um usuário de lugar único ou, então, o mesmo arquivo de
mudanças está tentando também fornecer o mesmo usuário com uma
assinatura de lugar único.
Por exemplo, esse erro ocorre quando uma operação AssignSeat tenta
fornecer um usuário como parte de uma assinatura empacotada do
IBM SmartCloud Notes quando o usuário já é fornecido como uma
assinatura de lugar do Engage.
Um usuário pode ser fornecido como parte de uma assinatura
empacotada ou como uma assinatura de lugar único, mas não ambos.
1089
ERROR_STORAGE_SUB_INCOMPATIBLE_WITH_BASE_SUB
A assinatura de armazenamento especificada não é compatível com a
assinatura base à qual ela está sendo associada.
1090
ERROR_ACCESSORY_SUBSCRIPTION_NOT_SUPPORTED
Uma assinatura de acessório foi especificada no arquivo CSV, mas o
recurso de assinatura de acessório não está disponível.
1095
ERROR_INVALID_ACTIVATION_VALUE
Um valor inválido, ou nenhum valor, foi especificado para o campo
Ativação. O único valor disponível é FORCE_ACTIVATION.
1096
ERROR_CANNOT_FORCE_ACTIVATION
Ativação forçada com falha porque o usuário ou a organização não
atendeu aos critérios requeridos.
1097
ERROR_FORCE_ACTIVATION_FAILED
Ativação forçada com falha devido à ocorrência de um erro no
sistema interno.
84
85
86
Capítulo 11. Diário
Visualize a atividade do usuário na conta da sua organização.
Visão Geral do Serviço de Diário
O diário é um registro da atividade do usuário na sua conta da empresa. Ele inclui data, horário e
informações sobre o usuário referentes a eventos como tentativas de logon, mudanças de senha e horários
de início de reuniões on-line.
Aproximadamente a cada 24 horas, o serviço de diário produz diversos arquivos de diário, um para cada
componente do IBM SmartCloud for Social Business. Cada arquivo é compactado usando gzip e
disponibilizado por meio do FTPS no site de integração e migração do SmartCloud for Social Business.
Depois de sete dias no site, os arquivos são removidos. Cada arquivo compactado contém um arquivo de
texto simples que está no formato legível por humanos. O formato é consistente e regular para que os
arquivos de texto possam ser analisados programaticamente.
Terminologia
serviço de diário
O sistema que monta os diários nos arquivos, os compacta e os torna disponíveis no site de
integração e migração.
diário O diário é um registro de eventos. Está contido em um ou mais arquivos de diário.
arquivo de diário
Um arquivo de texto simples que contém registros dos eventos executados pelos usuários.
registro
Uma entrada completa no arquivo de diário. Contém a data, o horário e outros detalhes sobre um
evento.
componente
Um serviço ou recurso no SmartCloud for Social Business. Por exemplo, Arquivos é um
componente e Atividades é um componente.
evento
Uma ação que um usuário executou na sua conta da empresa, como efetuar login, fazer
download de um arquivo ou alterar uma senha.
FTPS
Um protocolo de transferência de arquivos que usa o Segurança da Camada de Transporte para
fornecer comunicações seguras na Internet.
gzip
Um utilitário de compactação de arquivo. Use gunzip para descompactar os arquivos.
UUID Um identificador exclusivo universal, no formato hexadecimal.
87
“Fazendo Download de Arquivos de Diário do SmartCloud Engage” na página 121
Os arquivos de diário do SmartCloud Engageficam armazenados no site de FTP por sete dias.
“Permitindo o Serviço de Diário” na página 121
É possível ativar o diário quando ativar o acesso ao site de integração e migração.
Referências relacionadas:
“Formato dos Arquivos de Diário”
O diário é um arquivo de texto simples que contém um ou mais registros dos eventos que ocorreram
dentro da conta da sua empresa.
Formato dos Arquivos de Diário
O diário é um arquivo de texto simples que contém um ou mais registros dos eventos que ocorreram
dentro da conta da sua empresa.
“Visão Geral do Serviço de Diário” na página 87
Descrição Geral do Formato do Arquivo de Diário
O formato de um arquivo de diário é consistente e regular. É possível criar uma ou mais ferramentas
para analisar o conteúdo.
Introdução
Os Diários para uma conta de empresa são divididos em vários arquivos de texto compactados, um por
componente. Cada arquivo contém um ou mais registros dos eventos que ocorreram dentro do
componente para a conta da sua empresa. Se nenhum evento para a conta da sua empresa ocorrer em um
dia específico, nenhum arquivo do componente será gerado para esse dia.
Versão
A versão atual do serviço de diário é 2. O número da versão não é incluído nos arquivos de diário.
Embora as mudanças nos arquivos de diário não sejam frequentes, o IBM SmartCloud for Social Business
é um sistema constantemente em desenvolvimento que é melhorado e atualizado regularmente. Uma
atualização maior para o sistema pode resultar em mudanças nos nomes de arquivos de diário que
aparecem no servidor. Uma atualização maior também pode resultar em mudanças no conteúdo dos
arquivos de diário. Se você criar uma ferramenta para analisar os arquivos de diário, torne a ferramenta
suficientemente flexível para suportar as mudanças que podem ocorrer.
Nome do Arquivo
O nome do arquivo compactado que você faz download para um componente é
<data>.<componente>.txt.gz. A <data> é a data em que o diário foi gravado, no formato AAAA-MM-DD.
O <componente> é o nome usado para o arquivo de diário de um componente. Na maioria dos casos,
<componente> é idêntico ao nome real do componente no LotusLive. Por exemplo:
v 2011-12-06.CONTACT.txt.gz
v 2011-12-06.ACTIVITIES.txt.gz
v 2011-12-06.FILES2.txt.gz
88
Sintaxe
Todos os registros estão em conformidade com o formato geral:
DATE user SUBJECT performed ACTION [ON_OBJECT] [TARGETED_AT]
with outcome OUTCOME [reason=REASON] [(EXTRA)]
A more detailed view of the format is as follows:
DATE user email (id=subscriberId, customerId=customerId) performed ACTION
[on object (type=TYPE, id=OBJECTID, name="name", customerId=customerId)]
[targeted at (type=TYPE, id=TARGETID, name="name", customerId=customerId)]
with outcome OUTCOME [reason=REASON][(EXTRA)]
Notas:
1. Para se ajustar à largura da página, a sintaxe do registro é mostrada em várias linhas. No arquivo do
diário, cada registro é uma única linha.
2. O conteúdo entre [ e ] estará presente somente se aplicável ao evento registrado.
3. O uso de parênteses () é necessário para grupar atributos de objeto ou assunto
Parâmetros
DATE
A data e hora desse evento ocorreu em UTC. Por exemplo: 2011-06-30T13:23:47+0000
SUBJECT
A pessoa que executou a ação. A pessoa pode ser um membro de sua organização, um membro
em outra organização que possui uma conta no LotusLive ou um usuário anônimo. A sintaxe de
SUBJECT é: email (id=subscriberID, customerId=customerId).
e-mail
O endereço de e-mail da pessoa que executou a ação. Se a pessoa for um membro de sua
organização, este será o endereço de email completo. Se a pessoa tiver uma conta no IBM
SmartCloud Engage mas não for um membro de sua organização, o endereço de email será
apenas o domínio. Por exemplo, @example.com Se a pessoa for um usuário anônimo, o email será
o texto unauthenticated.
subscriberId e customerId
Números exclusivos que identificam cada pessoa e organização. Os números nunca são alterados
e reutilizados, mesmo quando uma pessoa ou organização é excluída. Se uma pessoa não tiver
uma conta, o subscriberId e o customerId não serão números; em vez disso, eles serão o texto
unknown.
Exemplos:
O usuário está em sua organização: [email protected] (id=2343, customerId=623449)
O usuário está em outra organização: @othercompany.com (id=3456, customerId=128)
O usuário não é um membro de SmartCloud Engage: unauthenticated
(id=unknown, customerId=unknown)
ACTION
Um valor de texto que descreve a ação que foi executada por um usuário. Os valores de texto são
específicos para um componente e são tabulados em uma seção separada desta documentação.
Nota: À medida que os recursos dos componentes se desenvolvem, novas ações podem ser
incluídas no arquivo de diário e ações podem ser removidas. Se você criar uma ferramenta para
analisar os arquivos de diário, torne a ferramenta suficientemente flexível para suportar as
mudanças que podem ocorrer.
89
ON_OBJECT
O objeto no qual a ação foi executada. Nem todas as ações têm objetos. A sintaxe é: on object
(type=TYPE, id=OBJECTID, name=name, customerId=customerId).
TARGETED_AT
O objeto para o qual o evento foi destinado. Na maioria dos casos, o objeto é o usuário de
destino de um evento de compartilhamento. A sintaxe é: targeted at (type=TYPE, id=TARGETID,
name=name, customerId=customerId).
TYPE
O tipo do objeto no qual a ação foi executada. Cada componente tem um ou mais valores que são
usados para TYPE. Alguns valores são comuns em todos os componentes. Por exemplo, USER é
um valor comum.
Nota: À medida que os recursos dos componentes se desenvolvem, novos tipos podem ser
incluídos no arquivo de diário e tipos podem ser removidos. Se você criar uma ferramenta para
OBJECTID e TARGETID
O identificador exclusivo do objeto ou destino. O formato do valor é consistente no arquivo de
diário para qualquer componente, mas não é consistente entre os componentes. Em alguns
componentes, o valor é um UUID, mas em outros é um número. O valor não é alterado durante
o ciclo de vida do objeto ou destino.
Nota: À medida que os recursos dos componentes se desenvolvem, o formato dos identificadores
para objetos e destinos recém-criados pode ser alterado. Se você criar uma ferramenta para
name
O nome do objeto que corresponde ao OBJECTID ou TARGETID. O formato é texto simples
arbitrário e é um nome de usuário, um nome de arquivo ou outro nome de objeto. O nome de
um objeto ou destino pode variar ao longo do tempo. Por exemplo, um usuário pode alterar o
nome de um arquivo.
OUTCOME
O resultado da ação. É quase sempre SUCCESS ou FAILURE. Nem todos os componentes têm
eventos que resultam em uma falha.
REASON
Se o resultado de um evento for FAILURE, o motivo é dado. O motivo depende do tipo de falha,
o evento e o componente. O motivo é a maiúscula e pode ser diversas palavras separadas por
sublinhados. Por exemplo: reason=AUTHENTICATION_FAILURE.
Nota: À medida que os recursos dos componentes se desenvolvem, novos motivos podem ser
incluídos no arquivo de diário e motivos podem ser removidos. Se você criar uma ferramenta
para analisar os arquivos de diário, torne a ferramenta suficientemente flexível para suportar as
EXTRA
Contém informações adicionais que são relevantes no contexto de algumas ações. As informações
estão no formato de pareas nome/valor no formato name="value".
Nota: Novos pares nome/valor podem ser incluídos no serviço de diário e pares nome/valor
podem ser removidos a qualquer momento, incluindo entre os arquivos de diário com o mesmo
número de versão. Se você criar uma ferramenta para analisar os arquivos de diário, torne a
ferramenta suficientemente flexível para suportar as mudanças que podem ocorrer.
90
Formato do Arquivo de Diário para Atividades
O arquivo de diário para Atividades contém eventos, tais como, criar, atualizar, excluir e copiar
Atividades.
Nome do Arquivo
O nome do arquivo compactado do qual você faz download é <data>ACTIVITIES.txt.gz, em que <data>
é a data em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo: 2011-1023.ACTIVITIES.txt.gz.
Sintaxe
Cada registro no arquivo de diário para Atividades está em conformidade com a sintaxe a seguir:
date user email (id=subscriberId, customerId=customerId) performed ACTION
[on object (type=TYPE, id=OBJECTID, name=name, customerId=customerId)]
[targeted at (type=TYPE, id=TARGETID, name=name, customerId=customerId)]
Notas:
Parâmetros
date
e-mail
O endereço de e-mail da pessoa que executou a ação.
subscriberId
O identificador exclusivo da pessoa que executou a ação.
customerId
O número exclusivo que identifica cada empresa que foi inscrita no SmartCloud Engage.
ACTION
A ação que foi executada pelo usuário. A ação é um dos valores a seguir:
Tabela 11. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para Atividades.
Ação do usuário
Texto no arquivo de diário
Anexar arquivo à entrada
ATTACH_ENTRY_FILE
Concluir automaticamente
AUTO_COMPLETE_ACTIVITY
Concluir atividade
COMPLETE_ACTIVITY
Marcar atividade como concluída
COMPLETE_ACTIVITY
Concluir pendência
COMPLETE_TODO
Copiar atividade
COPY_ACTIVITY
Mover atividade
COPY_ACTIVITY, COPY_ACTIVITY_FROM
Criar atividade
CREATE_ACTIVITY
Criar tag
CREATE_ACTIVITY_TAG
Criar resposta
CREATE_COMMENT
Incluir entrada
CREATE_ENTRY
Incluir marcador
ADD_ENTRY_BOOKMARK
Incluir campo customizado
ADD_ENTRY_CUSTOM_FIELD
Criar tag de entrada
CREATE_ENTRY_TAG
Incluir atividade relacionada
ADD_RELATED_ACTIVITY
91
Tabela 11. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para
Atividades. (continuação)
Ação do usuário
Criar seção
CREATE_SECTION
Criar modelo
CREATE_TEMPLATE
Criar pendência
CREATE_TODO
Excluir atividade
DELETE_ACTIVITY
Excluir tag
DELETE_ACTIVITY_TAG
Excluir resposta
DELETE_COMMENT
Excluir entrada
DELETE_ENTRY
Excluir marcador
DELETE_ENTRY_BOOKMARK
Excluir campo customizado
DELETE_ENTRY_CUSTOM_FIELD
Excluir arquivo de entrada
DELETE_ENTRY_FILE
Excluir tag de entrada
DELETE_ENTRY_TAG
Remover atividade relacionada
REMOVE_RELATED_ACTIVITY
Excluir seção
DELETE_SECTION
Excluir modelo
DELETE_TEMPLATE
Excluir pendência
DELETE_TODO
Fazer download de arquivos anexados
DOWNLOAD_ENTRY_FILE
Duplicar entrada
DUPLICATE_ENTRY, DUPLICATE_ENTRY_FROM
Mover entrada
MOVE_ENTRY, MOVE_ENTRY_TO_ACTIVITY, MOVE_ENTRY_FROM_ACTIVITY
Mover seção
MOVE_SECTION
Reordenar entradas
REORDER_ENTRY
Substituir arquivo de entrada
REPLACE_ENTRY_FILE
Copiar como novo modelo
SAVE_ACTIVITY_AS_TEMPLATE, SAVE_TEMPLATE_AS_TEMPLATE
Salvar como modelo
SAVE_ACTIVITY_AS_TEMPLATE, SAVE_TEMPLATE_AS_TEMPLATE
Configurar prioridade
SET_PRIORITY
Marcar como sintonizado
TUNE_IN_ACTIVITY
Marcar como dessintonizado
TUNE_OUT_ACTIVITY
Atividade não concluída
UNCOMPLETE_ACTIVITY
Pendência não concluída
UNCOMPLETE_TODO
Desfazer a exclusão da atividade
UNDELETE_ACTIVITY
Desfazer a exclusão da resposta
UNDELETE_COMMENT
Desfazer a exclusão da entrada
UNDELETE_ENTRY
Desfazer a exclusão da seção
UNDELETE_SECTION
Desfazer a exclusão da pendência
UNDELETE_TODO
Editar atividade
UPDATE_ACTIVITY
Tornar a atividade interna
UPDATE_ACTIVITY_ACCESS
Atualizar associação
UPDATE_ACTIVITY_MEMBERSHIP
Atualizar visibilidade
UPDATE_ACTIVITY_VISIBILITY
Atualizar resposta
UPDATE_COMMENT
Atualizar entrada
UPDATE_ENTRY
Editar marcador
UPDATE_ENTRY_BOOKMARK
Editar campo customizado
UPDATE_ENTRY_CUSTOM_FIELD
Atualizar seção
UPDATE_SECTION
Atualizar modelo
UPDATE_TEMPLATE
Atualizar pendência
UPDATE_TODO
TYPE
O tipo do objeto em que a ação foi executada. Alguns valores possíveis são USER e ACTIVITY.
OBJECTID
O identificador exclusivo do objeto. Por exemplo, quando o tipo de objeto é USER, o OBJECTID é
o número exclusivo que identifica a pessoa que tem a conta do SmartCloud Engage.
name
O nome que corresponde ao OBJECTID ou ao TARGETID. Por exemplo, quando o tipo de objeto
é ACTIVITY, o name é o nome da Atividade.
TARGETID
92
O identificador do objeto, empresa ou usuário em que a ação foi executada.
OUTCOME
O resultado da ação. Pode ser SUCCESS ou FAILURE.
REASON
Se o resultado de um evento for FAILURE, o motivo é dado. O motivo está em caracteres
maiúsculos e pode ser diversas palavras separadas por sublinhados. Por exemplo:
reason=AUTHENTICATION_FAILURE
EXTRA
Contém informações adicionais que são relevantes no contexto de algumas ações.
Exemplos
Nota: Para ajustar a largura dessa página, os registros de exemplo são mostrados em mais de uma linha.
No arquivo do diário, cada registro é uma única linha.
1. Uma Atividade foi criada com o nome Marketing Planning for 2012.
2011-10-20T21:36:56+0000 user [email protected] (id=20087962, customerId=20083694)
performed CREATE_ACTIVITY on object (type=ACTIVITY, id=FFFG29278562ddf343c58391d036388b2203,
name="Marketing Planning for 2012", customerId=20083694) with outcome SUCCESS
2. Uma Atividade foi atualizada para incluir Kristin MacGyver como um proprietário.
performed UPDATE_ACTIVITY_MEMBERSHIP on object (type=USER, id=30081007,
name="Kristin MacGyver", customerId=20083694) targeted at (type=ACTIVITY,
id=FFFG29278562ddf343c58391d036388b2203, name="Marketing Planning for 2012",
customerId=20083694) with outcome SUCCESS (ROLE="OWNER", OPERATION="MEMBER_ADDED")
Formato do Arquivo de Diário para Comunicados
O arquivo de diário para Comunicados contém eventos para criar, atualizar e excluir comunicados.
Nome do Arquivo
O nome do arquivo compactado do qual você faz download é <data>.ANNOUNCEMENT.txt.gz, em que
<data> é a data em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo:
2011-10-23.ANNOUNCEMENT.txt.gz.
Sintaxe
Cada registro no arquivo de diário para Comunicados está em conformidade com a sintaxe a seguir:
Notas:
Parâmetros
date
e-mail
93
subscriberId
customerId
ACTION
Tabela 12. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para Anúncios.
Ação do usuário
Criar um comunicado
CREATE
Editar, ativar ou desativar um comunicado
UPDATE
Excluir um comunicado
DELETE
TYPE
O tipo do objeto em que a ação foi executada. O valor é sempre ANNOUNCEMENT.
OBJECTID
O identificador exclusivo do comunicado.
name
O título do comunicado.
OUTCOME
REASON
maiúsculos e pode ser diversas palavras separadas por sublinhados.
Exemplos
1. Um comunicado foi criado para lembrar às pessoas que elas têm um dia de folga:
performed CREATE on object (type=ANNOUNCEMENT, id=8e9dab6a-4ebbf4f8405d0,
name="Company Holiday", customerId=20083694) with outcome SUCCESS
(link="", linktext="", enabled="1", modifiedby="20087962", body="Please do not forget
that Friday is a day off for everyone.")
2. Um comunicado foi desativado:
performed UPDATE on object (type=ANNOUNCEMENT, id=8e9dab6a-4ebbf4f8405d0,
name="Company Holiday", customerId=20083694)
with outcome SUCCESS (enabled="0", modifiedby="20087962")
Formato do Arquivo de Diário para Autenticação
O diário para autenticação contém registros de tentativas de login e mudanças de senha.
Nome do Arquivo
O nome do arquivo compactado do qual você faz download é <data>.AUTH.txt.gz, em que <data> é a
data em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo: 2011-10-23.AUTH.txt.gz.
94
Sintaxe
Cada registro no arquivo de diário para Autenticação está em conformidade com a sintaxe a seguir:
date user email (id=subscriberId, customerId=customerId)
performed ACTION
with outcome OUTCOME [reason=REASON]
Notas:
Parâmetros
date
e-mail
subscriberId
customerId
ACTION
Tabela 13. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para Eventos de
Autenticação.
Ação do usuário
Autenticação da página de login
LOGIN
Autenticação por meio de um aplicativo, por
exemplo Lotus Notes Traveler
LOGIN_BASIC
A senha de um aplicativo que usa o login da
configuração básica (por exemplo, Lotus Notes
Traveler)
LOGIN_APP_PASSWORD
Autenticação federada
LOGIN_SSO
O usuário seleciona Logout
LOGOUT
Autenticação federada externa
EXTERNAL_SSO
Mudança de senha expirada
PASSWORD_CHANGE
OUTCOME
O resultado da ação. Pode ser SUCCESS, FAILURE, PENDING ou UNKNOWN.
REASON
Tabela 14. Eventos de Autenticação e as Razões para a Falha que Aparecem no Arquivo de Diário.
Evento
Motivo para a falha
LOGIN
Credenciais incorretas
AUTHENTICATION_FAILURE
LOGIN
Número máximo de tentivas com falha excedido
MAX_FAILED_LOGINS_EXCEEDED
LOGIN
O usuário não existe
INVALID_USERNAME
LOGIN
Senha expirada
PASSWORD_EXPIRED
LOGIN
A conta do usuário está suspensa
ACCOUNT_SUSPENDED
95
Tabela 14. Eventos de Autenticação e as Razões para a Falha que Aparecem no Arquivo de Diário. (continuação)
Evento
Motivo para a falha
LOGIN
O motivo para a falha não é conhecido
NOT_SUPPORTED
LOGIN_SSO
O usuário não existe
INVALID_USERNAME
LOGIN_SSO
O usuário foi excluído ou não está ativo
ACCOUNT_SUSPENDED
LOGIN_SSO
Cliente não federado
CUSTOMER_NOT_ENTITLED
LOGIN_SSO
O cliente é federado, mas o usuário não está autorizado
USER_NOT_ENTITLED
LOGIN_SSO
A senha não pôde ser verificada devido a um erro de serviço interno.
ERROR_BSS
LOGIN_SSO
ERROR_TAM
LOGIN_BASIC
Número máximo de tentivas com falha excedido
MAX_FAILED_LOGINS_EXCEEDED
LOGIN_BASIC
ERROR_TAM
LOGIN_APP_PASSWORD
A senha foi revogada pelo usuário ou a senha expirou.
PASSWORD_EXPIRED
LOGOUT
O motivo da falha é desconhecido.
NOT_SUPPORTED
PASSWORD_CHANGE
Falha na mudança de senha expirada
POLICY_VIOLATION
PASSWORD_CHANGE
O motivo da falha é desconhecido.
NOT_SUPPORTED
EXTERNAL_SSO
ERROR
EXTERNAL_SSO
O usuário não está autorizado
USER_NOT_ENTITLED
Exemplos
1. Uma tentativa de login bem-sucedida:
performed LOGIN with outcome SUCCESS
2. Uma falha de login porque o usuário não digitou a senha correta:
performed LOGIN with outcome FAILURE reason=AUTHENTICATION_FAILURE
Formato do Arquivo de Diário para Blogs
O arquivo de diário para Blogs contém eventos como criar, atualizar e excluir Blogs
Nome do Arquivo
O nome do arquivo compactado do qual você faz o download é <date>.BLOGS.txt.gz, em que <date> é a
data em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo: 2011-10-23.BLOGS.txt.gz.
Sintaxe
Cada registro no arquivo de diário para Blogs está em conformidade com a seguinte sintaxe:
Notas:
Parâmetros
date
e-mail
96
subscriberId
customerId
ACTION
Tabela 15. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para Blogs.
Ação do usuário
Um novo blog foi criado
CREATE_BLOG
Um blog foi excluído
DELETE_BLOG
Um blog foi configurado
UPDATE_BLOG_SETTINGS
Um blog de ideação foi criado
CREATE_IDEATION_BLOG
Um blog de ideação foi excluído
DELETE_IDEATION_BLOG
Uma nova entrada de blog foi criada
CREATE_BLOG_ENTRY
Um rascunho de uma nova entrada de blog foi salva
SAVE_BLOG_ENTRY_DRAFT
Uma entrada de blog foi atualizada
UPDATE_BLOG_ENTRY
Uma entrada de blog foi excluída
DELETE_BLOG_ENTRY
Uma entrada de blog foi recomendada
RECOMMEND_BLOG_ENTRY
Um comentário foi incluído em uma entrada de blog
ADD_BLOG_COMMENT
Um comentário foi removido de uma entrada de blog
REMOVE_BLOG_COMMENT
Um comentário do blog foi recomendado
RECOMMEND_BLOG_COMMENT
Um arquivo foi transferido por upload para um blog
UPLOAD_BLOG_FILE
Um arquivo foi removido de um blog
REMOVE_BLOG_FILE
Um link foi incluído em uma entrada de blog
ADD_BLOG_LINK
Um link foi atualizado
UPDATE_BLOG_LINK
Um link foi removido de uma entrada de blog
REMOVE_BLOG_LINK
TYPE
O tipo de mudança ocorrida no blog.
OBJECTID
O identificador exclusivo do blog.
name
O nome que corresponde ao OBJECTID ou ao TARGETID.
TARGETID
OUTCOME
REASON
Formato do Arquivo de Diário para BSS
O arquivo de diário para BSS contém eventos que ocorrem na conta da organização. Os eventos incluem
reconfigurar senhas, incluir usuários guest e alterar funções de usuário.
97
Nome do Arquivo
O nome do arquivo compactado do qual você faz download é <data>.BSS.txt.gz, em que <data> é a data
em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo: 2011-10-23.BSS.txt.gz.
Sintaxe
Cada registro no arquivo de diário para BSS está em conformidade com a sintaxe a seguir:
Notas:
Parâmetros
date
e-mail
subscriberId
customerId
ACTION
Tabela 16. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para BSS.
Ação do usuário
Aceitar Contrato
ACCEPTAGREEMENT
Aceitar Contrato de Prestação de Serviços
ACCEPTSERVICEAGREEMENT
Aceitar Termos de Uso
ACCEPTTERMSOFUSE
Incluir Conta de Cliente
ADDACCOUNT
Incluir Endereço
ADDADDRESS
Incluir Atributo de Cliente
ADDCUSTOMERATTRIBUTE
Incluir Identificador de Cliente
ADDCUSTOMERIDENTIFIER
Incluir no carrinho de compras/ordem
ADDITEM
Incluir Atributo de Componente de Serviço
ADDSERVICECOMPONENTATTRIBUTE
Incluir Assinante
ADDSUBSCRIBER
Incluir Atributo de Assinante
ADDSUBSCRIBERATTRIBUTE
Permitir acesso à API
ALLOWAPI
Incluindo funções no perfil do Usuário
ASSIGNROLE
Autorizar
AUTHORIZE
Excluir Assinatura
CANCELSUBSCRIPTION
Cancelar Fluxo de Trabalho
CANCELWORKFLOW
Alterar Senha
CHANGEPASSWORD
Alterar Cota
CHANGEQUOTA
Verificar Política de Senha
CHECKPASSWORDPOLICY
Criar Carrinho de Compras/Ordem
CREATECART
Criar Componente de Serviço
CREATESERVICECOMPONENT
98
Tabela 16. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para BSS. (continuação)
Ação do usuário
Criar Token
CREATETOKEN
Excluir token de acesso
DELETEACCESSTOKEN
Excluir Carrinho de Compras/Ordem
DELETECART
Excluir Componente de Serviço
DELETESERVICECOMPONENT
Excluir Atributo de Componente de Serviço
DELETESERVICECOMPONENTATTRIBUTE
Excluir Token do Usuário
DELETETOKEN
Autorizar todos os Assinantes
ENTITLEALLSUBSCRIBERS
Incluir Usuário Guest
ENTITLESUBSCRIBER
Autorizar Assinante
ENTITLESUBSCRIBER
Obter política de expiração de Senha do Cliente
GETCUSTOMERPASSWORDEXPIRY
Obter Endereços IP
GETIPADDRESSES
Obter Credenciais Oauth
GETOAAUTHCREDENTIALS
Obter Lista de Funções
GETROLELIST
Obter Tokens de Oauth 2
GETTOKENS
Obter informações do Datacenter do Usuário
GETUSERDATACENTERS
Login do usuário (geralmente pelo Sametime Client)
LOGIN
Registrar Cliente
REGISTERCUSTOMER
Liberar Ordem de Vendas
RELEASESALESORDER
Excluir Conta de Cliente
REMOVEACCOUNT
Excluir Endereço
REMOVEADDRESS
Excluir Atributo de Cliente
REMOVECUSTOMERATTRIBUTE
Excluir Identificador de Cliente
REMOVECUSTOMERIDENTIFIER
Excluir item do carrinho de compras/ordem
REMOVEITEM
Remover Assinante
REMOVESUBSCRIBER
Excluir Atributo de Assinante
REMOVESUBSCRIBERATTRIBUTE
Reenviar Correio de Boas-vindas
RESENDWELCOMEMAIL
Reconfigurar Credenciais Oauth
RESETOAUTHCREDENTIALS
Reconfigurar Senha
RESETPASSWORD
Reiniciar Fluxo de Trabalho
RESTARTWORKFLOW
Revogar todos os Assinantes
REVOKEALLSUBSCRIBERS
Revogar Assinante
REVOKESUBSCRIBER
Configurar Endereço IP
SETIPADDRESS
Configurar Senha Descartável
SETONETIMEPASSWORD
Configurar senha de usuário
SETPASSWORD
Enviar Carrinho de Compras/Ordem
SUBMITCART
Suspender Cliente
SUSPENDCUSTOMER
Suspender Assinante
SUSPENDSUBSCRIBER
Suspender Assinatura
SUSPENDSUBSCRIPTION
Suspender Usuário
SUSPENDUSER
Componentes de Serviço de Sincronização
SYNCSERVICECOMPONENTS
Alternar Restrição de Endereço IP
TOGGLEIPADDRESSRESTRICTION
Transferir Lugar
TRANSFERSEAT
Transferir Assinante
TRANSFERSUBSCRIBER
Removendo funções do perfil do usuário
UNASSIGNROLE
Excluir Cliente
UNREGISTERCUSTOMER
Cancelar Suspensão do Cliente
UNSUSPENDCUSTOMER
Cancelar Suspensão do Assinante
UNSUSPENDSUBSCRIBER
Cancelar Suspensão da Assinatura
UNSUSPENDSUBSCRIPTION
Cancelar Suspensão do Usuário
UNSUSPENDUSER
Atualizar Conta de Cliente
UPDATEACCOUNT
Atualizar Endereço
UPDATEADDRESS
Atualizar Carrinho de Compras/Ordem
UPDATECART
Modificar Perfil do Cliente
UPDATECUSTOMER
Atualizar Cliente
UPDATECUSTOMER
Atualizar Atributo de Cliente
UPDATECUSTOMERATTRIBUTE
Atualizar Endereço IP
UPDATEIPADDRESS
Atualizar item no carrinho de compras/ordem
UPDATEITEM
Atualizar Lugar
UPDATESEAT
99
Tabela 16. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para BSS. (continuação)
Ação do usuário
Atualizar Componente de Serviço
UPDATESERVICECOMPONENT
Atualizar Assinante
UPDATESUBSCRIBER
Atualizar Atributo de Assinante
UPDATESUBSCRIBERATTRIBUTE
Atualizar Assinatura
UPDATESUBSCRIPTION
Validar token do usuário
VALIDATETOKEN
TYPE
O tipo do objeto em que a ação foi executada. Alguns valores possíveis são CUSTOMER, USER e
FILE.
OBJECTID
o número exclusivo que identifica cada pessoa que tem uma conta.
name
é CUSTOMER, o nome é o nome da empresa.
TARGETID
OUTCOME
REASON
reason=INVALID_LOGINNAME_OR_PASSWORD
EXTRA
Exemplos
1. O usuário [email protected] alterou sua senha:
2012-01-25T21:42:12+0000 user [email protected] (id=30081144, customerId=30046242) performed
CHANGEPASSWORD with outcome SUCCESS
2. O administrador suspendeu um usuário:
SUSPENDSUBSCRIBER with outcome SUCCESS
Formato do Arquivo de Diário para Comunidades
O arquivo de diário para Comunidades contém eventos, tais como, iniciar uma Comunidade, incluir
marcadores e atualizar associação na Comunidade.
Dentro de uma Comunidade, os eventos que estão relacionados a Atividades, Arquivos e Fóruns são
registrados nos arquivos de diário para Atividades, Arquivos e Fóruns. Por exemplo, se um usuário
atualizar uma Atividade que está dentro de uma Comunidade, o evento de atualização será registrado no
arquivo de diário para Atividades.
100
Guia do Administrador do IBM SmartCloud for Social Business: IBM SmartCloud Engage e do IBM SmartCloud
Connections
Nome do Arquivo
O nome do arquivo compactado do qual você faz download é <data>.COMMUNITIES.txt.gz, em que
<data> é a data em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo:
2011-10-23.COMMUNITIES.txt.gz.
Sintaxe
Cada registro no arquivo de diário para Comunidades está em conformidade com a sintaxe a seguir:
date user email (id=subscriberId) performed ACTION
Notas:
Parâmetros
date
e-mail
subscriberId
customerId
ACTION
Tabela 17. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para Comunidades.
Ação do usuário
Iniciar uma comunidade
CREATE_COMMUNITY
Customizar comunidade
CUSTOMIZE_COMMUNITY_ADD, CUSTOMIZE_COMMUNITY_REMOVE
Editar comunidade
UPDATE_COMMUNITY
Excluir comunidade
DELETE_COMMUNITY
Incluir marcador
ADD_COMMUNITY_BOOKMARK
Editar marcador
UPDATE_COMMUNITY_BOOKMARK
Remover marcador
REMOVE_COMMUNITY_BOOKMARK
Associação atualizada
UPDATE_COMMUNITY_MEMBERSHIP
Associação incluída
ADD_TO_COMMUNITY_MEMBERSHIP
Associação removida
REMOVE_FROM_COMMUNITY_MEMBERSHIP
Proprietário de negócios alterado
COMMUNITY_BUSINESS_OWNER_CHANGED
TYPE
O tipo do objeto em que a ação foi executada. Alguns valores possíveis são COMMUNITY e
USER.
OBJECTID
o número exclusivo que identifica cada pessoa que tem uma conta no SmartCloud Engage.
101
name
é COMMUNITY, o name é o nome da Comunidade.
TARGETID
O identificador do objeto no qual a ação foi executada.
OUTCOME
REASON
EXTRA
Exemplos
1. Uma comunidade com o nome Marketing foi criada:
performed CREATE_COMMUNITY on object (type=COMMUNITY, id=1bce14a4-c105-4c66-9ceb-0682a24dc076,
name="Marketing", customerId=20083694) with outcome SUCCESS
2. Um usuário nomeado Kristin MacGyver foi incluído na comunidade:
performed ADD_TO_COMMUNITY_MEMBERSHIP on object (type=USER, id=30081007,
name="Kristin MacGyver", customerId=20083694) targeted at (type=COMMUNITY,
id=1bce14a4-c105-4c66-9ceb-0682a24dc076, name="Marketing", customerId=20083694)
with outcome SUCCESS (ROLE="OWNER", OPERATION="MEMBER_ADDED")
3. Um usuário nomeado Alain Amadou foi incluído no widget de Fórum para uma comunidade:
performed CUSTOMIZE_COMMUNITY_ADD on object (type=WIDGET,
id=d037d0d4-b4f4-43b0-befb-3a38ab5324de, name="Forum", customerId=30046242)
targeted at (type=COMMUNITY, id=d037d0d4-b4f4-43b0-befb-3a38ab5324de,
name="", customerId=30046242) with outcome SUCCESS
Referências relacionadas:
“Formato do Arquivo de Diário para Atividades” na página 91
O arquivo de diário para Atividades contém eventos, tais como, criar, atualizar, excluir e copiar
Atividades.
“Formato do Arquivo de Diário para Arquivos” na página 105
O arquivo de diário para Arquivos contém registros de criação, compartilhamento e modificação de
arquivo e pasta.
“Formato do Arquivo de Diário para Fóruns” na página 110
O arquivo de diário para Fóruns contém registros de atividade do usuário em fóruns que estão em
Comunidades.
Formato do Arquivo de Diário para Administração da Empresa
O arquivo de diário para Administração da Empresa contém eventos que ocorrem quando um
administrador faz mudanças na visibilidade de usuários no diretório SmartCloud Engage, ou quando um
administrador modifica quaisquer campos customizados que estão em Perfis.
102
Connections
Nome do Arquivo
O nome do arquivo compactado do qual você faz download é <data>.COMPANY.txt.gz, em que <data> é
a data em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo: 2011-1023.COMPANY.txt.gz.
Sintaxe
Cada registro no arquivo de diário para Administração da Empresa está em conformidade com a sintaxe
a seguir:
Notas:
Parâmetros
date
e-mail
subscriberId
customerId
ACTION
Tabela 18. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para Administração de
Empresa.
Ação do usuário
Ocultar um usuário na página de diretório da empresa
SET_HIDE_VISIBILITY
Mostrar um usuário na página de diretório da empresa
SET_SHOW_VISIBILITY
Incluir um campo customizado em Perfis
ADD_NEW_FIELD
Editar um campo customizado em Perfis
EDIT_FIELD
Excluir um campo customizado de Perfis
DELETE_FIELD
Atualizar informações da empresa
UPDATE
TYPE
FILE.
OBJECTID
name
103
TARGETID
OUTCOME
REASON
EXTRA
Exemplos
1. Um administrador incluiu um novo campo na página de perfil de cada usuário na empresa
Renovations:
performed ADD_NEW_FIELD on object (type=COMPANY, id=30046242, name="Renovations",
customerId=30046242) with outcome SUCCESS
Formato do Arquivo de Diário para Contatos
O arquivo de diário para Contatos contém registros de quando os usuários criam, atualizam e excluem
contatos.
Nome do Arquivo
O nome do arquivo compactado do qual você faz download é <data>.CONTACT.txt.gz, em que <data> é
a data em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo: 2011-1023.CONTACT.txt.gz.
Sintaxe
Cada registro no arquivo de diário para Contatos está em conformidade com a sintaxe a seguir:
Notas:
Parâmetros
date
e-mail
104
Connections
subscriberId
customerId
ACTION
Tabela 19. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para Contatos.
Ação do usuário
Criar um contato
CREATE
Excluir um contato
DELETE
TYPE
O tipo do objeto em que a ação foi executada. O valor é sempre CONTACT.
OBJECTID
O identificador exclusivo do contato que foi criado, atualizado ou excluído.
name
O nome do contato. Por exemplo, "Samantha Daryn".
OUTCOME
REASON
Exemplos
1. O usuário [email protected] criou um novo contato:
performed CREATE on object (type=CONTACT, id=102474, name="Heather Reeds", customerId=20083694)
with outcome SUCCESS
2. O usuário [email protected] excluiu um contato:
performed DELETE on object (type=CONTACT, id=96455, name="Mike Motler", customerId=20083694)
Formato do Arquivo de Diário para Arquivos
O arquivo de diário para Arquivos contém registros de criação, compartilhamento e modificação de
arquivo e pasta.
Nome do Arquivo
O nome do arquivo compactado do qual você faz download é <data>.FILES2.txt.gz, em que <data> é a
data em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo: 2011-10-23.FILES2.txt.gz.
105
Sintaxe
Cada registro no arquivo de diário para Arquivos está em conformidade com a sintaxe a seguir:
Notas:
Parâmetros
date
e-mail
subscriberId
customerId
ACTION
Tabela 20. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para Arquivos.
Ação do usuário
Uma pasta é criada. Esse evento pode ser recebido quando uma
comunidade é criada ou quando o arquivo é compartilhado com
uma comunidade (o destino é COMMUNITY)
COLLECTION_CREATED
Uma pasta é excluída. Esse evento pode ser recebido quando uma
comunidade remove o widget Arquivos (o destino é
COMMUNITY)
COLLECTION_DELETED
O nome ou descrição de uma pasta foi atualizado. Esse evento
também será recebido quando uma comunidade alterar seu nome
(o destino é COMMUNITY)
COLLECTION_UPDATED
Um comentário é incluído em um arquivo
CREATE_FILE_COMMENT
Uma ou mais tags foram incluídas em um arquivo por um editor
CREATE_FILE_TAG
Um arquivo é incluído em uma coleção por outro membro (o
destino é FOLDER) ou um arquivo é compartilhado com uma
comunidade (o destino é COMMUNITY)
FILE_ADDED_TO_COLLECTION
Um arquivo é incluído em uma pasta pelo proprietário (o destino
é FOLDER) ou um arquivo é compartilhado com uma comunidade
(o destino é COMMUNITY)
FILE_ADDED_TO_COLLECTION
Um arquivo é movido para a lixeira de uma biblioteca pessoal ou
uma comunidade
FILE_DELETED
Um arquivo é transferido por download.
FILE_DOWNLOADED
Um arquivo foi editado usando IBM Docs
FILE_EDITED
Um arquivo é bloqueado por um proprietário ou editor.
FILE_LOCKED
Um arquivo é removido de uma coleção (o destino é FOLDER) ou
um arquivo não é mais compartilhado com uma comunidade (o
destino é COMMUNITY)
FILE_REMOVED_FROM_COLLECTION
Um arquivo foi restaurado da lixeira de uma biblioteca pessoal ou
uma comunidade.
FILE_RESTORED
Quando um compartilhamento de arquivo é criado com outro
usuário, ainda que tenha sido compartilhado anteriormente.
FILE_SHARED
Um arquivo foi compartilhado com um usuário que ainda não se
juntou ao SmartCloud for Social Business.
FILE_SHARED_FOR_SINGLE_DOWNLOAD
106
Connections
Arquivos. (continuação)
Ação do usuário
Um arquivo foi transferido por download por um usuário que
ainda não se juntou ao SmartCloud for Social Business.
FILE_SINGLE_DOWNLOAD
Um ou mais usuários foram incluídos ou removidos da lista de
compartilhamento para um arquivo (o tipo de objeto é USER) ou o
arquivo tornou-se público com a organização (o tipo de objeto é
ORGANIZATION)
FILE_SHARING_UPDATED
O usuário parou o compartilhamento do arquivo.
FILE_STOP_SHARING
Um arquivo é desbloqueado por um proprietário ou editor.
FILE_UNLOCKED
Uma nova versão de um arquivo é criada, ou outros atributos do
arquivo são alterados
FILE_UPDATED
Qualquer usuário faz upload de um arquivo para sua biblioteca
pessoal ou uma comunidade
FILE_UPLOADED
Um arquivo foi visualizado no navegador
FILE_VIEWED
Um ou mais usuários foram incluídos ou removidos da lista de
compartilhamento para uma pasta (o tipo de objeto é USER) ou a
pasta tornou-se pública com a organização (o tipo de objeto é
ORGANIZATION)
FOLDER_SHARING_UPDATED
Quando uma pasta deixou de ser compartilhada com um
indivíduo ou grupo
Quando uma pasta foi recompartilhada com um indivíduo ou
grupo que já a tinha recebido
Um comentário é excluído de um arquivo
REMOVE_FILE_COMMENT
Uma ou mais tags foram removidas de um arquivo por um editor
REMOVE_FILE_TAG
Uma versão mais antiga de um arquivo foi removida
permanentemente.
REMOVE_FILE_VERSION
Uma versão mais antiga de um arquivo foi restaurada para ser a
versão atual.
RESTORE_FILE_VERSION
Um comentário é atualizado em um arquivo
UPDATE_FILE_COMMENT
TYPE
O tipo do objeto em que a ação foi executada. Alguns valores possíveis são FOLDER, FILE, USER
e ALL.
OBJECTID
O identificador exclusivo do objeto. Por exemplo, quando o tipo de objeto é FILE, o OBJECTID é
o UUID que identifica o arquivo.
name
é FILE, o name é o nome do arquivo que foi afetado.
TARGETID
OUTCOME
REASON
EXTRA
Exemplos
107
1. O arquivo Marketing Presentation.odp foi transferido por upload por user1.
performed FILE_UPLOADED on object (type=FILE, id=0d916c35-0c08-4b1d-b45f-7727dacff274,
name="Marketing Presentation.odp", customerId=30079205) with outcome SUCCESS
2. O arquivo Marketing Presentation.odp foi transferido por download por user2.
performed FILE_DOWNLOADED on object (type=FILE, id=0d916c35-0c08-4b1d-b45f-7727dacff274,
name="Marketing Presentation.odp", customerId=30079205) with outcome SUCCESS
3. Quando um arquivo é compartilhado com um usuário, dois eventos são registrados. O primeiro
evento é a ação de compartilhamento de arquivo. O segundo evento indica com quem o arquivo foi
compartilhado. Ambos os eventos possuem o mesmo registro de data e hora e o mesmo endereço de
email de usuário.
O usuário [email protected] compartilhou um arquivo chamado alain.amadou.jpg com Mike
Motler:
FILE_SHARED on object (type=FILE, id=48b871e9-c552-421f-a36d-c24e847fd3d4,
name="alain.amadou.jpg", customerId=30046242) with outcome SUCCESS
FILE_SHARING_UPDATED on object (type=USER, id=30076007, name="Mike Motler", customerId=30046242)
targeted at (type=FILE, id=48b871e9-c552-421f-a36d-c24e847fd3d4, name="alain.amadou.jpg",
customerId=30046242) with outcome SUCCESS (ROLE="READER", OPERATION="MEMBER_ADDED")
4.
O usuário [email protected] parou de compartilhar um arquivo chamado alain.amadou.jpg com
Mike Motler:
FILE_SHARING_UPDATED on object (type=USER, id=30076007, name="Mike Motler", customerId=30046242)
targeted at (type=FILE, id=48b871e9-c552-421f-a36d-c24e847fd3d4, name="alain.amadou.jpg",
customerId=30046242) with outcome SUCCESS (ROLE="UNSET", OPERATION="MEMBER_REMOVED")
5. Quando um arquivo é incluído em uma Comunidade do computador de um usuário, dois eventos são
registrados. O primeiro evento é o upload de arquivo. O segundo evento é o evento
FILE_ADDED_TO_COLLECTION com o destino COMMUNITY. Ambos os eventos possuem o mesmo
registro de data e hora e o mesmo endereço de email de usuário.
O usuário [email protected] fez upload do arquivo progress report.txt para a Comunidade Sales
and Marketing team:
FILE_UPLOADED on object (type=FILE, id=d3465761-289e-499e-8cf5-a56fc1a405f3,
name="progress report.txt", customerId=30046242) targeted at (type=COMMUNITY,
id=d037d0d4-b4f4-43b0-befb-3a38ab5324de, name="Sales and Marketing team",
FILE_ADDED_TO_COLLECTION on object (type=FILE, id=d3465761-289e-499e-8cf5-a56fc1a405f3,
name="progress report.txt", customerId=30046242) targeted at (type=COMMUNITY,
id=9c73b03f-606a-4643-a7e9-159ed0e961f8, name="Sales and Marketing team",
6. O usuário [email protected] compartilhou o arquivo chamado alain.amadou.jpg com sua
organização:
FILE_SHARING_UPDATED on object (type=ORGANIZATION, id=30046242, name="Renovations",
customerId=30046242) targeted at (type=FILE, id=48b871e9-c552-421f-a36d-c24e847fd3d4,
name="alain.amadou.jpg", customerId=30046242)
with outcome SUCCESS (ROLE="READER", OPERATION="GROUP_ADDED")
Formato do Arquivo de Diário para Formulários
O arquivo de diário para Formulários contém eventos, tais como, criar pesquisas de opinião, publicar
pesquisas de opinião e editar modelos de pesquisa de opinião.
108
Connections
Nome do Arquivo
O nome do arquivo compactado do qual você faz download é <data>.FORMS.txt.gz, em que <data> é a
data em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo: 2011-10-23.FORMS.txt.gz.
Sintaxe
Cada registro no arquivo de diário para Formulários está em conformidade com a sintaxe a seguir:
Notas:
Parâmetros
date
e-mail
subscriberId
customerId
ACTION
Tabela 21. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para Formulários.
Ação do usuário
Criar um modelo Formulário
CREATE_TEMPLATE
Fazer uma cópia do modelo Formulário
COPY_TEMPLATE
Editar um modelo Formulário
EDIT_TEMPLATE
Publicar um Formulário para outro(s) usuário(s)
PUBLISH_TO_USERS
Publicar um Formulário para a empresa
PUBLISH_TO_COMPANY
Publicar um Formulário para todos (formulário público)
PUBLISH_TO_ALL
Preencher um Formulário
SUBMIT
Criar um Formulário a partir de um Formulário no disco (arquivo
xml)
CREATE_SURVEY_FROM_DISK
Criar um Formulário a partir de um modelo
CREATE_SURVEY_FROM_TEMPLATE
Cancelar Publicação de um Formulário
UNPUBLISH_SURVEY
Integrar um Formulário Público a outra página da web
EMBED_FORM
Incluir um link de URL no Formulário em uma página da web
EMBED_LINK
Visualizar os envios de Formulário
VIEW_RESULTS
TYPE
O tipo do objeto em que a ação foi executada. Alguns valores possíveis são TEMPLATE, USER e
FILE.
OBJECTID
109
O UUID que identifica o objeto. Por exemplo, quando o tipo de objeto é TEMPLATE, o
OBJECTID é o UUID que identifica o modelo de formulário.
name
é TEMPLATE, o name é o nome que o usuário configurou para o modelo. Por exemplo: "Modelo
de Pesquisa de Opinião de Marketing"
TARGETID
O identificador do objeto, empresa ou usuário em que a ação foi executada. O TARGETID tem
um dos valores a seguir:
v um UUID
v 0
v PUBLIC
OUTCOME
REASON
EXTRA
Exemplos
1. Um formulário chamado Sales Meeting Feedback foi criado a partir de um modelo:
performed CREATE_SURVEY_FROM_TEMPLATE on object (type=FORM, id=0,
name="Sales Meeting Feedback", customerId=30078115)
2. Um formulário chamado Sales Meeting Feedback foi publicado e está disponível para todas as pessoas
na Internet:
performed PUBLISH_TO_ALL on object (type=FORM, id=85722fcf376745cd9b2cd3df9f4b82ba,
name="Sales Meeting Feedback", customerId=30078115)
targeted at (type=PUBLIC, id=PUBLIC, name="PUBLIC", customerId=0)
Formato do Arquivo de Diário para Fóruns
O arquivo de diário para Fóruns contém registros de atividade do usuário em fóruns que estão em
Comunidades.
Nome do Arquivo
O nome do arquivo compactado do qual você faz download é <data>.FORUMS.txt.gz, em que <data> é a
data em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo: 2011-10-23.FORUMS.txt.gz.
Sintaxe
Cada registro no arquivo de diário para Fóruns está em conformidade com a sintaxe a seguir:
110
Connections
Notas:
Parâmetros
date
e-mail
subscriberId
customerId
ACTION
Tabela 22. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para Fóruns.
Ação do usuário
Criar Fórum
CREATE_FORUM
Atualizar Fórum
UPDATE_FORUM
Excluir Fórum
DELETE_FORUM
Desfazer a Exclusão do Fórum
UNDELETE_FORUM
Mover Fórum
MOVE_FORUM
Bloquear Fórum
LOCK_FORUM
Desbloquear Fórum
UNLOCK_FORUM
Seguir Fórum
FOLLOW_FORUM
Parar de seguir um Fórum
UNFOLLOW_FORUM
Incluir uma tag em um Fórum
CREATE_FORUM_TAG
Remover uma tag de um Fórum
DELETE_FORUM_TAG
Criar um tópico em um Fórum
CREATE_TOPIC
Atualizar um tópico
UPDATE_TOPIC
Excluir um tópico
DELETE_TOPIC
Desfazer a exclusão de um tópico
UNDELETE_TOPIC
Mover um tópico
MOVE_TOPIC
Bloquear um tópico
LOCK_TOPIC
Desbloquear um tópico
UNLOCK_TOPIC
Seguir um tópico
FOLLOW_TOPIC
Parar de seguir um tópico
UNFOLLOW_TOPIC
Incluir uma tag em um tópico
CREATE_TOPIC_TAG
Remover uma tag de um tópico
DELETE_TOPIC_TAG
Fazer upload de um anexo para um tópico
UPLOAD_TOPIC_ATTACHMENT
Remover um anexo de um tópico
DELETE_TOPIC_ATTACHMENT
Fazer o download de um anexo de um tópico
DOWNLOAD_TOPIC_ATTACHMENT
Responder a um tópico
CREATE_TOPIC_REPLY
Atualizar uma resposta para um tópico
UPDATE_TOPIC_REPLY
Excluir uma resposta para um tópico
DELETE_TOPIC_REPLY
Fazer upload de um anexo para uma resposta
UPLOAD_TOPIC_REPLY_ATTACHMENT
Excluir um anexo de uma resposta
DELETE_TOPIC_REPLY_ATTACHMENT
111
Fóruns. (continuação)
Ação do usuário
Fazer o download de um anexo de uma resposta
DOWNLOAD_TOPIC_REPLY_ATTACHMENT
TYPE
O tipo do objeto em que a ação foi executada. Alguns valores possíveis são FOLDER, FILE, USER
e ALL.
OBJECTID
O identificador exclusivo do objeto. Por exemplo, quando o tipo de objeto é FILE, o OBJECTID é
o UUID que identifica o arquivo.
name
é FILE, o name é o nome do arquivo que foi afetado.
TARGETID
OUTCOME
REASON
EXTRA
Exemplos
1. Quando um fórum é criado em uma Comunidade, a pessoa que criou o fórum é incluída
automaticamente como um seguidor do fórum. Por esse motivo, dois eventos são registrados. Um
evento é CREATE_FORUM e o outro evento é FOLLOW_FORUM. Ambos os eventos possuem o
mesmo registro de data e hora e email de usuário. O evento FOLLOW_FORUM aparece primeiro no
arquivo de diário.
O usuário [email protected] criou um fórum chamado Renovations Running Club:
performed FOLLOW_FORUM on object (type=FORUM, id=dcecaa72-1d7c-4ad0-8d56-314d4168cccd,
name="Renovations Running Club", customerId=30046242) with outcome SUCCESS
performed CREATE_FORUM on object (type=FORUM, id=dcecaa72-1d7c-4ad0-8d56-314d4168cccd,
name="Renovations Running Club", customerId=30046242) with outcome SUCCESS
2. O usuário [email protected] fez o download de um arquivo que estava anexado ao tópico
Proposals for 2012 no fórum Sales and Marketing team:
performed DOWNLOAD_TOPIC_ATTACHMENT on object (type=FILE, id=, name="Marketing Presentation.odp",
customerId=30046242) targeted at (type=FORUM, id=520bbc45-83bb-4346-b4d5-377edf4ca220,
name="Sales and Marketing team", customerId=30046242)
with outcome SUCCESS (TOPIC="Proposals for 2012")
112
Connections
Formato do Arquivo de Diário para o iNotes
O arquivo de diário para o iNotes contém um registro de cada tentativa de login e seu resultado.
Nome do Arquivo
O nome do arquivo compactado do qual você faz download é <data>.INOTES.txt.gz, em que <data> é a
data em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo: 2011-10-23.INOTES.txt.gz.
Sintaxe
Cada registro no arquivo de diário para o iNotes está em conformidade com a sintaxe a seguir:
Notas:
Parâmetros
date
e-mail
O endereço de email da pessoa que efetuou login.
subscriberId
O identificador exclusivo da pessoa que efetuou login.
customerId
ACTION
Tabela 23. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para iNotes.
Ação do usuário
Efetuar login no iNotes
LOGIN
OUTCOME
REASON
Exemplo
Nota: Para ajustar a largura dessa página, o registro de exemplo é mostrado em mais de uma linha. No
arquivo do diário, cada registro é uma única linha.
1.
113
Formato do Arquivo de Diário para Reuniões
O arquivo de diário para Reuniões contém registros da atividade do usuário em uma reunião.
Nome do Arquivo
O nome do arquivo compactado do qual você faz download é <data>.MEETINGS.txt.gz, em que <data> é
a data em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo: 2011-1023.MEETINGS.txt.gz.
Sintaxe
Cada registro no arquivo de diário para Reuniões está em conformidade com a sintaxe a seguir:
Notas:
Parâmetros
date
e-mail
subscriberId
customerId
ACTION
Tabela 24. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para Reuniões.
Ação do usuário
Hospedar uma reunião
START
Junção de Participante
JOIN
Deixar uma reunião
LEAVE
Terminar uma reunião
END
Bloquear uma reunião
LOCK
Desbloquear uma reunião
UNLOCK
Passar controle
PASSCONTROL
Publicar um arquivo
PUBLISH
Apresentar um arquivo
PRESENT
Iniciar Compartilhar Tela/Aplicativo
APPSHARESTART
Parar Compartilhar Tela/Aplicativo
APPSHARESTOP
Conduzir uma pesquisa
CONDUCTPOLL
Atividade de Bate-papo da Reunião
CHAT
TYPE
114
Connections
FILE.
OBJECTID
name
TARGETID
OUTCOME
REASON
EXTRA
Exemplos
1. Uma reunião foi iniciada por [email protected]:
performed START on object (type=MEETING, id=347414, name="348766", customerId=20083694)
with outcome SUCCESS (unmSubscriberName="4371ca9fdc687f1e6", unmServiceProvider="SBS",
unmSecondaryServiceProvider="none")
2. O usuário [email protected] juntou-se à reunião:
performed JOIN on object (type=MEETING, id=347414, name="348766", customerId=20083694)
with outcome SUCCESS (unmParticipantId="3249049", unmParticipantFirstName="Kristin",
unmParticipantLastName="")
Formato do Arquivo de Diário para Perfis
O arquivo de diário para Perfis contém informações sobre a rede de contatos entre os usuários. O arquivo
de diário também contém registros ou atualizações para o perfil de um usuário.
Nome do Arquivo
O nome do arquivo compactado do qual você faz download é <data>.PROFILE.txt.gz, em que <data> é a
data em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo: 2011-10-23.PROFILE.txt.gz.
Sintaxe
Cada registro no arquivo de diário para Perfis está em conformidade com a sintaxe a seguir:
115
Notas:
Parâmetros
date
e-mail
subscriberId
customerId
ACTION
Tabela 25. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para Perfis.
Ação do usuário
Aceitar solicitação de rede
ACCEPT_NETWORK_INVITATION
Remover o arquivo de áudio do perfil
DELETE_AUDIO
Remover a foto do perfil
DELETE_PHOTO
Rejeitar solicitação de rede
REJECT_NETWORK_INVITATION
Remover contato da rede
REMOVE_NETWORK_CONNECTION
Remover uma identificação do perfil
REMOVE_TAG
Incluir uma identificação ao perfil que pertence ao usuário
SELFTAG
Incluir contato na rede (Convidar contato para a rede)
SEND_NETWORK_INVITATION
Incluir uma identificação ao perfil de alguém
TAG_PERSON
Atualizar um perfil
UPDATE
Atualizar o arquivo de áudio do nome do usuário
UPDATE_AUDIO
Atualizar a foto do usuário
UPDATE_PHOTO
TYPE
O tipo do objeto em que a ação foi executada.
OBJECTID
O identificador exclusivo do usuário cuja rede ou perfil está sendo alterada.
name
O nome do usuário que corresponde ao OBJECTID ou ao TARGETID.
TARGETID
O identificador exclusivo do usuário que é o contato da rede.
OUTCOME
REASON
116
Connections
Exemplos
1. O usuário Alain Amadou atualizou suas informações de perfil:
performed UPDATE on object (type=USER, id=20087962, name="Alain Amadou",
2. O usuário Alain Amadou convidou Kristin MacGyver para esta rede:
performed SEND_NETWORK_INVITATION targeted at (type=USER, id=20083830,
name="Kristin MacGyver", customerId=20083694) with outcome SUCCESS
Formato do Arquivo de Diário para o Sametime
O arquivo de diário para o Sametime contém registros de quando as pessoas efetuam login no Sametime,
iniciam um bate-papo e efetuam logout do Sametime.
Nome do Arquivo
O nome do arquivo compactado do qual você faz download é <data>.SAMETIME.txt.gz, em que <data>
é a data em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo: 2011-1023.SAMETIME.txt.gz.
Sintaxe
Cada registro no arquivo de diário para o Sametime está em conformidade com a sintaxe a seguir:
with outcome OUTCOME
Notas:
Parâmetros
date
e-mail
subscriberId
customerId
ACTION
Tabela 26. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para Sametime.
Ação do usuário
Iniciar uma sessão de bate-papo
CHAT_INITIATION
Logon
LOGIN
117
Sametime. (continuação)
Ação do usuário
Logout
LOGOUT
TYPE
O tipo do objeto em que a ação foi executada. No diário para o Sistema de Mensagens
Instantâneas, o valor é sempre USER.
TARGETID
O identificador do usuário no qual a ação foi executada.
name
O nome que corresponde ao TARGETID. Por exemplo, "Kristin MacGyver"
customerId
OUTCOME
Exemplos
1. Um bate-papo que foi iniciado por [email protected] com Alain Amadou:
performed CHAT_INITIATION targeted at (type=USER, id=20332348, name="Alain Amadou",
2. Um login bem-sucedido que foi feito por [email protected]:
Formato do Arquivo de Diário para Temas
O arquivo de diário para Temas contém um evento de atualização que ocorre quando um administrador
altera o esquema de cores da interface do SmartCloud Engage para sua organização, ou o logotipo de sua
organização.
Nome do Arquivo
O nome do arquivo compactado do qual você faz download é <data>.THEME.txt.gz, em que <data> é a
data em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo: 2011-10-23.THEME.txt.gz.
Sintaxe
Cada registro no arquivo de diário para Temas está em conformidade com a sintaxe a seguir:
Notas:
118
Connections
Parâmetros
date
e-mail
subscriberId
customerId
ACTION
Tabela 27. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para Tema.
Ação do usuário
O tema é alterado
UPDATE
TYPE
O tipo de mudança que ocorreu no tema. O valor pode ser THEME, THEMELOGO,
THEMELOGODISPLAY ou THEMELOGINLOGO.
OBJECTID
O identificador exclusivo do tema.
name
O nome que corresponde ao tema que foi atualizado.
OUTCOME
REASON
Exemplos
1. Um novo logotipo da empresa foi transferido por upload:
performed UPDATE on object (type=THEMELOGO, id=1950, name="company-logo-small.gif",
2. O logotipo da empresa tornou-se visível:
performed UPDATE on object (type=THEMELOGODISPLAY, id=1950, name="1",
Formato do Arquivo de Diário para Wikis
O arquivo de diário para Wikis contém eventos, por exemplo como criar, atualizar e excluir Wikis
119
Nome do Arquivo
O nome do arquivo compactado do qual você faz o download é <date>.WIKIS.txt.gz, em que <date> é a
data em que o diário foi gravado, no formato AAAA-MM-DD. Por exemplo: 2011-10-23.WIKIS.txt.gz.
Sintaxe
Cada registro no arquivo de diário para Wikis está em conformidade com a seguinte sintaxe:
Notas:
Parâmetros
date
e-mail
subscriberId
customerId
ACTION
Tabela 28. Ações do Usuário e os Valores Associados que Aparecem no Arquivo de Diário para Wikis.
Ação do usuário
Um novo wiki foi criado
CREATE_WIKI
Um wiki foi excluído
DELETE_WIKI
Uma página de wiki foi criada
CREATE_WIKI_PAGE
Uma página de wiki foi atualizada
UPDATE_WIKI_PAGE
Uma página de wiki foi excluída
DELETE_WIKI_PAGE
Um comentário foi incluído em uma página de wiki
ADD_WIKI_PAGE_COMMENT
Um comentário foi atualizado
UPDATE_WIKI_PAGE_COMMENT
Um comentário foi removido de uma página de wiki
REMOVE_WIKI_PAGE_COMMENT
Um anexo foi incluído em uma página de wiki
ADD_WIKI_PAGE_ATTACHMENT
Um anexo foi atualizado
UPDATE_WIKI_PAGE_ATTACHMENT
Um anexo foi removido de uma página de wiki
REMOVE_WIKI_PAGE_ATTACHMENT
Uma tag foi incluída em uma página de wiki
ADD_WIKI_PAGE_TAG
Uma tag foi removida de uma página de wiki
REMOVE_WIKI_PAGE_TAG
Uma página de wiki foi recomendada
ADD_WIKI_PAGE_RECOMMENDATION
Uma recomendação foi removida de uma página de wiki
REMOVE_WIKI_PAGE_RECOMMENDATION
TYPE
O tipo de mudança ocorrida no wiki.
OBJECTID
120
Connections
O identificador exclusivo do wiki.
name
O nome que corresponde ao OBJECTID ou ao TARGETID.
TARGETID
OUTCOME
REASON
Permitindo o Serviço de Diário
É possível ativar o diário quando ativar o acesso ao site de integração e migração.
Sobre Esta Tarefa
Ao ativar o diário, você deve fornecer pelo menos um nome de usuário e identidade da conta que serão
usados para conectar-se ao site de FTP. É possível usar a sua própria conta ou criar uma conta no IBM
SmartCloud for Social Business para o propósito específico de conectar-se ao site de FTP e fazer o
download dos arquivos de diário.
Procedimento
Para ativar o serviço de diário para sua empresa, consulte o tópico Solicitando a Ativação do Servidor de
Integração.
ativação.
Fazendo Download de Arquivos de Diário do SmartCloud Engage
Os arquivos de diário do SmartCloud Engageficam armazenados no site de FTP por sete dias.
Antes de Iniciar
Certifique-se de ter as credenciais de login para a conta do usuário do SmartCloud Engage que foi
ativada para acesso ao site de migração e integração do SmartCloud Engage.
Se seu sistema estiver sob um firewall, certifique-se de que o firewall esteja configurado para permitir
conexões para a porta 990 e para o intervalo de portas de 60000 a 61000.
121
Sobre Esta Tarefa
Essas instruções são para um cliente de FTP genérico, mas as informações de login e conexão se aplicam
a todos os clientes de FTP.
Procedimento
Para fazer download dos arquivos de diário:
1. Abra o seu cliente FTP e insira os seguintes detalhes de conexão:
v Host (Datacenter da América do Norte): ftp.na.collabserv.com
v Host (Datacenter da Ásia-Pacífico): ftp.ap.collabserv.com
Protocolo: FTP
Porta: 990
Criptografia: FTP Implícito sobre TLS
Usuário e Senha: Insira as credenciais para a conta do usuário do SmartCloud Engage que foi
ativada para acesso ao site de integração e migração do SmartCloud Engage.
2. Conecte-se ao site de FTP.
3. No site remoto, vá para o diretório journal.
4. Selecione os arquivos desejados e faça download deles.
v
v
v
v
122
Connections
Avisos
Estas informações foram desenvolvidas para produtos e serviços oferecidos nos Estados Unidos.
É possível que a IBM não ofereça os produtos, serviços ou recursos discutidos nesta publicação em outros
países. Consulte um representante IBM local para obter informações sobre produtos e serviços disponíveis
atualmente em sua área. Qualquer referência a produtos, programas ou serviços IBM não significa que
apenas produtos, programas ou serviços IBM possam ser utilizados. Qualquer produto, programa ou
serviço funcionalmente equivalente, que não infrinja nenhum direito de propriedade intelectual da IBM
poderá ser utilizado em substituição a este produto, programa ou serviço. Entretanto, a avaliação e
verificação da operação de qualquer produto, programa ou serviço não IBM são de responsabilidade do
Cliente.
A IBM pode ter patentes ou solicitações de patentes pendentes relativas a assuntos tratados nesta
publicação. O fornecimento desta publicação não lhe garante direito algum sobre tais patentes. Pedidos
de licença devem ser enviados, por escrito, para:
Gerência de Relações Comerciais e Industriais da IBM Brasil
Av. Pasteur, 138-146
Botafogo
Rio de Janeiro, RJ
CEP 22290-240
Para pedidos de licença relacionados a informações de DBCS (Conjunto de Caracteres de Byte Duplo),
entre em contato com o Departamento de Propriedade Intelectual da IBM em seu país ou envie pedidos
de licença, por escrito, para:
Intellectual Property Licensing
Legal and Intellectual Property Law
IBM Japan, Ltd.
19-21, Nihonbashi-Hakozakicho, Chuo-ku
Tokyo 103-8510, Japan
O parágrafo a seguir não se aplica a nenhum país em que tais disposições não estejam de acordo com a
legislação local: A INTERNATIONAL BUSINESS MACHINES CORPORATION FORNECE ESTA
PUBLICAÇÃO "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA DE NENHUM TIPO, SEJA
EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS A ELAS NÃO SE LIMITANDO, AS GARANTIAS
IMPLÍCITAS DE NÃO INFRAÇÃO, COMERCIALIZAÇÃO OU ADEQUAÇÃO A UM DETERMINADO
PROPÓSITO. Alguns países não permitem a exclusão de garantias expressas ou implícitas em certas
transações; portanto, essa disposição pode não se aplicar ao Cliente.
Essas informações podem conter imprecisões técnicas ou erros tipográficos. São feitas alterações
periódicas nas informações aqui contidas; tais alterações serão incorporadas em futuras edições desta
publicação. A IBM pode, a qualquer momento, aperfeiçoar e/ou alterar os produtos e/ou programas
descritos nesta publicação, sem aviso prévio.
Referências nestas informações a websites não IBM são fornecidas apenas por conveniência e não
representam de forma alguma um endosso a esses websites. Os materiais contidos nesses websites não
fazem parte dos materiais desse produto IBM e a utilização desses websites é de inteira responsabilidade
do Cliente.
A IBM pode utilizar ou distribuir as informações fornecidas da forma que julgar apropriada sem incorrer
em qualquer obrigação para com o Cliente.
123
Licenciados deste programa que desejam obter informações sobre este assunto com objetivo de permitir:
(i) a troca de informações entre programas criados independentemente e outros programas (incluindo
este) e (ii) a utilização mútua das informações trocadas, devem entrar em contato com:
Gerência de Relações Comerciais e Industriais da IBM Brasil
Av. Pasteur, 138-146
Botafogo
Rio de Janeiro, RJ
CEP 22290-240
Tais informações podem estar disponíveis, sujeitas a termos e condições apropriadas, incluindo em alguns
casos o pagamento de uma taxa.
O programa licenciado descrito nesta publicação e todo o material licenciado disponível são fornecidos
pela IBM sob os termos do Contrato com o Cliente IBM, do Contrato Internacional de Licença do
Programa IBM ou de qualquer outro contrato equivalente.
Todos os dados de desempenho aqui contidos foram determinados em um ambiente controlado. Portanto,
os resultados obtidos em outros ambientes operacionais podem variar significativamente. Algumas
medidas podem ter sido tomadas em sistemas em nível de desenvolvimento e não há garantia de que
estas medidas serão iguais em sistemas geralmente disponíveis. Além disso, algumas medidas podem ter
sido estimadas por extrapolação. Os resultados reais podem variar. Os usuários deste documento devem
verificar os dados aplicáveis para seu ambiente específico.
As informações relativas a produtos não IBM foram obtidas junto aos fornecedores dos respectivos
produtos, de seus anúncios publicados ou de outras fontes disponíveis publicamente. A IBM não testou
estes produtos e não pode confirmar a precisão de seu desempenho, compatibilidade nem qualquer outra
reivindicação relacionada a produtos não IBM. Dúvidas sobre os recursos de produtos não IBM devem
ser encaminhadas diretamente a seus fornecedores.
Todas as declarações relacionadas aos objetivos e intenções futuras da IBM estão sujeitas a alterações ou
cancelamento sem aviso prévio e representam apenas metas e objetivos.
Todos os preços IBM mostrados são preços de varejo sugeridos pela IBM, são atuais e estão sujeitos a
alteração sem aviso prévio. Os preços do revendedor podem variar.
Estas informações foram projetadas apenas com o propósito de planejamento. As informações aqui
contidas estão sujeitas a alterações antes que os produtos descritos estejam disponíveis.
Estas informações contêm exemplos de dados e relatórios utilizados nas operações diárias de negócios.
Para ilustrá-los da forma mais completa possível, os exemplos incluem nomes de indivíduos, empresas,
marcas e produtos. Todos estes nomes são fictícios e qualquer semelhança com os nomes e endereços
utilizados por uma empresa real é mera coincidência.
LICENÇA DE COPYRIGHT:
Estas informações contêm programas de aplicativos de amostra na linguagem fonte, ilustrando as técnicas
de programação em diversas plataformas operacionais. O Cliente pode copiar, modificar e distribuir estes
programas de amostra sem a necessidade de pagar à IBM, com objetivos de desenvolvimento, utilização,
marketing ou distribuição de programas aplicativos em conformidade com a interface de programação de
aplicativo para a plataforma operacional para a qual os programas de amostra são criados. Esses
exemplos não foram testados completamente em todas as condições. Portanto, a IBM não pode garantir
ou implicar a confiabilidade, manutenção ou função destes programas. Os programas de amostra são
fornecidos "NO ESTADO EM QUE SE ENCONTRAM", sem garantia de nenhum tipo. A IBM não é
responsável por nenhum dano decorrente do uso dos programas de amostra.
124
Connections
Cada cópia ou parte destes programas de amostra ou qualquer trabalho derivado deve incluir um aviso
de copyright com os dizeres:
© (nome da empresa) (ano). Partes deste código são derivadas dos Programas de Amostras da IBM Corp.
© Copyright IBM Corp. _digite o ano ou anos_. Todos os direitos reservados.
Se estas informações estiverem sendo exibidas em cópia eletrônica, as fotografias e ilustrações coloridas
podem não aparecer.
Marcas Registradas
IBM, o logotipo IBM e ibm.com são marcas ou marcas registradas da International Business Machines
Corp., registradas em vários países no mundo todo. Outros nomes de produtos e serviços podem ser
marcas registradas da IBM ou de outras empresas. Uma lista atual de marcas registradas da IBM está
disponível na web em “Copyright and trademark information” em www.ibm.com/legal/copytrade.shtml.
Avisos
125
126
Connections
Impresso no Brasil

Guia do Administrador do IBM SmartCloud for Social

Transcrição

Documentos relacionados

Uma nova esperança na rede

Resumo Curricular - Smart City Business America

História da Computação

Inovação Social _ Kaos Pilot

Aplicações - Saúde

IBM Forum 2009

Historia dos Computadores

Segurança em um planeta mais inteligente

IBMista 32 - Revista IBMista

IBMista 40 - Revista IBMista