Exportações para planilhas

1. Qual escolher

Ambos fazem o mesmo trabalho. A diferença é qual conta sua empresa já usa.

	Google Sheets	Microsoft SharePoint
Uma linha se torna	uma linha acrescentada a uma planilha	um item em uma lista
Você fornece	uma chave de conta de serviço e o ID da planilha	tenant, ID do cliente, segredo do cliente, ID do site e ID da lista
Colunas	ordem fixa, oito colunas	as que sua lista tiver — consultamos antes
Trabalho de configuração	criar uma conta de serviço e compartilhar a planilha com ela	registrar um aplicativo e conceder acesso a um site

2. Google Sheets: a etapa de compartilhamento que todos esquecem

Uma conta de serviço é um usuário por si só, com seu próprio endereço de e-mail terminado em .iam.gserviceaccount.com. Criar a chave não basta: você precisa compartilhar a planilha com esse endereço, exatamente como faria com um colega.

Sem isso, toda gravação retorna 403. Indicamos esse motivo explicitamente na mensagem de erro, porque a mensagem do Google não o menciona e as pessoas acabam passando uma tarde investigando a chave.

Cole a URL completa se for mais fácil

O ID da planilha é o trecho entre /d/ e /edit. Cole o endereço inteiro no campo e extraímos a parte necessária.

Os valores são gravados sem interpretação, de propósito

Sem a opção de interpretar como dados inseridos pelo usuário. Caso contrário, o Google leria um ID de cliente como 00123 como número e descartaria os zeros à esquerda, e um valor iniciado com = se tornaria uma fórmula.

3. SharePoint: lemos suas colunas antes de gravar

O SharePoint rejeita um item que mencione uma coluna inexistente na lista, e os nomes internos das colunas são aqueles que você escolheu ao criar a lista. Presumir um conjunto fixo seria uma aposta que falharia para metade dos clientes.

Por isso, consultamos as colunas da lista uma vez por hora e gravamos apenas nas que existem e não são somente leitura. Uma lista que só tenha a coluna padrão Title recebe apenas o nome da meta, em vez de falhar a cada meta.

As colunas opcionais, se você as criar: MPSession, MPChannel, MPUser, MPValue, MPCurrency, MPUrl, MPTime.

A permissão recomendada pela Microsoft não é a que você precisa

Para esta chamada, a documentação da Microsoft apresenta Sites.ReadWrite.All como a permissão de menor privilégio. Ela dá acesso de gravação a todos os sites do seu tenant, para uma integração que preenche uma única lista.

Use Sites.Selected em vez disso: por padrão, um aplicativo com essa permissão não tem acesso algum, e um administrador concede acesso de gravação a exatamente um site. Conceder ambas anula a restrição : a permissão restrita só funciona enquanto o aplicativo não tiver outra mais ampla.

4. O que aparece na linha

Carimbo de data e hora, projeto, sessão, ID do cliente, nome da meta, valor, moeda e o link para reproduzir a gravação. No SharePoint, os mesmos valores são inseridos nas colunas existentes, no formato exigido pelo tipo de cada coluna: uma coluna de hiperlink recebe um objeto de link; uma coluna de texto recebe o mesmo endereço como texto.

Uma célula vazia significa “nenhum valor acordado”, e não zero

Uma meta sem valor monetário deixa a célula vazia. Um zero entraria na soma de um total que nunca existiu na planilha.

O ID do cliente é consultado no momento da entrega

E não quando a meta é acionada. A identificação geralmente ocorre no login, ou seja, muitas vezes depois da meta. Consultar alguns segundos mais tarde custa menos para nosso processamento de eventos e aumenta a chance de encontrar um nome.