Skip to main content

microsoft-onedrive-icon.png Microsoft OneDrive

O conector do OneDrive permite que você se conecte ao armazenamento em nuvem do Microsoft OneDrive no Designer. O OneDrive está disponível como uma fonte de dados nas ferramentas Dados de Entrada e Dados de Saída.

Atualizar para o novo conector do OneDrive

Se o fluxo de trabalho usa as ferramentas independentes Entrada ou Saída do OneDrive, elas agora estão descontinuadas. Em vez disso, use a versão do conector 2.2.0 ou posterior com as ferramentas Dados de Entrada e Dados de Saída. Use o utilitário de migração de fluxo de trabalho para atualizar os fluxos de trabalho existentes.Output Data Tool Icon Ferramenta Dados de Saída

Pré-requisitos

Antes de prosseguir, certifique-se de ter concluído os seguintes pré-requisitos:

Requisito

Detalhes

Designer

Designer 2026.1 ou posterior.

Designer 2025.2 Patch 3 ou posterior.

Designer 2025.1 Patch 5 ou posterior.

Versão do conector

Microsoft OneDrive versão 2.2.0 ou posterior. Disponível nos add-ons do Designer.

Permissões do Azure

Consulte Configurar o aplicativo da API do Microsoft Azure.

DCM

Você deve habilitar o DCM no Designer. Vá para Opções >Configurações avançadas > DCM para habilitá-lo.

Acesso à rede

Acesso de saída para pontos de extremidade do OneDrive Online e do Microsoft OAuth.

Instalar o conector

Instale a versão mais recente do conector do OneDrive diretamente do Designer usando add-ons. Esse é o método de instalação recomendado que permite navegar, instalar e atualizar conectores sem sair do Designer ou visitar o Alteryx Marketplace.

Para instalar o conector...

  1. No Designer, vá para Add-Ons > Gerenciar add-ons do Marketplace. Você verá uma lista de conectores disponíveis.

  2. Selecione Conector do Microsoft OneDrive e clique em Instalar. O Designer baixa e instala o pacote. O Designer pode precisar ser reiniciado para concluir a instalação.

  3. Após a conclusão da instalação e da configuração, o conector do OneDrive estará disponível nas ferramentas Dados de Entrada e Dados de Saída.

Configurar uma conexão

Para se conectar ao Microsoft OneDrive...

  1. Arraste a ferramenta Dados de Entrada ou Dados de Saída para a tela e selecione Conectar aos dados.

  2. Em Configuração do conector , selecione Criar ou procurar uma conexão de dados.

    Se você já criou uma conexão do Microsoft OneDrive antes, pode selecioná-la na guia Recentes.

  3. Clique em + Novo. Na lista de tecnologias, selecione Microsoft OneDrive.

  4. Insira o Nome da conexão e o Nome da fonte de dados.

  5. Na seção Credenciais, selecione seu método de autenticação e insira as credenciais. Para obter mais informações, consulte Métodos de autenticação.

  6. Clique em Salvar. Você também pode testar a conexão antes de salvar.

  7. Clique em Conectar. O Microsoft OneDrive pode solicitar autenticação.

  8. Selecione a configuração de leitura ou gravação na janela Opções. Para saber mais sobre as opções, consulte Ler dados do OneDrive ou Gravar dados no OneDrive.Ler dados do OneDriveGravar dados no OneDrive

  9. Clique em Confirmar para criar uma conexão com o arquivo. Você pode continuar criando seu fluxo de trabalho.

Migração de fluxos de trabalho

Se os seus fluxos de trabalho existentes usarem as ferramentas Entrada do OneDrive ou Saída do OneDrive descontinuadas, você precisará migrá-las para usar o novo conector. Use o utilitário de migração de fluxo de trabalho para atualizar os fluxos de trabalho existentes.

O utilitário visualiza todas as alterações e substitui instâncias de ferramentas descontinuadas pelas novas versões do conector sem interromper os fluxos de trabalho.

Métodos de autenticação

O Microsoft OneDrive é compatível com três métodos de autenticação. Use a tabela abaixo para escolher a melhor opção para o seu caso de uso.

Método

Detalhes

Azure AD – privado (aplicativo nativo)

  • Use isso para configurar uma conexão pessoal e ad hoc com suas próprias credenciais da Microsoft.

  • O e-mail e a senha estão vinculados às suas credenciais pessoais da Microsoft.

  • Isso pode ser usado para SDK.

  • Não recomendado para agendar fluxos de trabalho.

  • O DCM é opcional.

Azure AD – privado (aplicativo personalizado)

Entidade de serviço (aplicativo)

  • Use esta opção para agendar ou automatizar fluxos de trabalho sem vincular a autenticação a um usuário específico.

  • Aproveita as capacidades de aplicativos de API personalizados com uma entidade de serviço.

  • Para obter instruções sobre a configuração, consulte Configuração do aplicativo de API do Microsoft Azure.

  • O DCM é obrigatório.

Limitações

Atualmente, o conector do Microsoft OneDrive tem as seguintes limitações:

  • As APIs de gráfico subjacentes da Microsoft Recentes e Compartilhados comigo foram descontinuadas e não retornam dados. Essa é uma limitação no nível da plataforma, independente desse conector.

    Como resultado, Recentes e Compartilhados comigo não ficam navegáveis nem acessíveis, e o escopo do caminho do OneDrive fica limitado a Meus arquivos.

  • Não há suporte para particionamento.

  • Não há suporte para a leitura de dados com caracteres curinga ou de múltiplos arquivos ou pastas, mas isso pode ser feito usando macros.

  • A ação de saída Acrescentar não é compatível. Use Ler > União > Substituir para replicar o comportamento de acréscimo.

  • Ao criar um novo arquivo, se um arquivo com o mesmo nome já existir no destino, a ação não o substituirá. Em vez disso, ele adicionará um sufixo de carimbo de data/hora ao nome do novo arquivo, mantendo ambos os arquivos.

  • Não há suporte para a leitura de arquivos XLSX com múltiplas planilhas ou para selecionar uma planilha por nome ou índice.

Versão

Descrição

v3.1.1

  • Melhorado o campo URL da autoridade com um valor padrão pré-preenchido e texto de ajuda em linha, reduzindo a necessidade de consultar documentação externa.

  • Corrigido um problema em que selecionar um formato de arquivo incompatível no conector de Entrada do OneDrive mostrava opções de configuração irrelevantes.

  • Corrigido um problema em que o Teste de conexão falhava no DCM ao usar o tipo de autenticação do aplicativo integrado.

  • Melhorado o tratamento de erros das operações de Entrada e Saída do OneDrive.

v3.1.0

  • Compatível com o Designer 2021.4.2 Patch 4, 2022.1 Patch 2 e versões posteriores.

  • Capacidade de se conectar ao OneDrive usando o login seguro do OAuth 2.0 da Microsoft.

  • Faça a autenticação com uma entidade de serviço para fluxos de trabalho automatizados e não supervisionados.

  • Armazene seu login uma vez por meio do DCM e reutilize-o em fluxos de trabalho no Designer e no Server.

  • Execute trabalhos não supervisionados no Server com atualização automática de token, sem necessidade de reautenticação manual.

  • Filtre rapidamente por Arquivos pessoais,Compartilhados comigo ou Arquivos recentes.

  • Escolha arquivos navegando, digitando um caminho manualmente ou simplesmente colando um link compartilhado do OneDrive.

  • Cole um URL e o conector identificará e carregará automaticamente os detalhes do arquivo.

  • Escolha uma planilha específica por nome ou número, defina um intervalo de células personalizado ou extraia apenas a lista de nomes de planilha.

  • Importe detalhes, como nome do arquivo, caminho, tamanho, data da última modificação e tipo de arquivo, juntamente com seus dados.

  • Recupere apenas a estrutura de arquivos/pastas sem baixar o conteúdo completo do arquivo.

  • Leia arquivos .csv, .xlsx e .yxdb diretamente do OneDrive.

v2.3.0

  • Compatível com o Designer 2021.4.2 Patch 4, 2022.1 Patch 2 e versões posteriores.

  • Compatível apenas com AMP Engine.

  • O DCM é necessário para executar este conector no Alteryx Server.

  • Melhoria da janela de opções de autenticação.

  • A saída da ferramenta Entrada do OneDrive agora inclui os nomes das planilhas quando você baixa arquivos XLSX localmente. Você pode usar os nomes das planilhas em outras ferramentas do seu fluxo de trabalho.

  • Corrigido o problema em que a ferramenta Saída do OneDrive configurada para substituir uma planilha específica no arquivo XLSX modificava outras planilhas também.

  • Corrigido o problema em que a autenticação das ferramentas do OneDrive não funcionava corretamente. (TPM-3833)

  • Corrigido o problema em que a ferramenta Entrada do OneDrive não lia determinados tipos de dados corretamente. (TPM-3751, TPM-3722, TPM-3721)

  • Corrigido o problema em que a ferramenta Saída do OneDrive gravava arquivos incorretos se os dados continham valores decimais fixos ou nulos. (TPM-3720)

  • Corrigido o problema em que a ferramenta Saída do OneDrive convertia incorretamente valores nulos em arquivos CSV. (TPM-3719)

  • Corrigido o problema em que a autenticação da entidade de serviço não funcionava corretamente na ferramenta Saída do OneDrive. (TPM-3580)

  • Corrigido o problema em que, apesar das configurações do usuário para excluir o campo das opções "Selecionar planilha", a ferramenta Saída do OneDrive incluía o campo na saída. (TPM-3393)

  • Corrigido o problema em que a ferramenta Saída do OneDrive não agregava dados corretamente. (TPM-2564)

  • Corrigido o problema em que a opção "Abortar" da ferramenta Saída do OneDrive não funcionava corretamente para todos os tipos de dados. (TPM-2563)

  • Corrigidos os problemas de codificação das ferramentas do OneDrive. (TPM-1984)

  • Corrigido o problema em que a ferramenta Saída do OneDrive mudava o formato dos cabeçalhos. (TPM-1375)

  • Corrigido o problema em que a opção "Agregar" da Saída do OneDrive substituía a formatação e as fórmulas do documento. (TPM-1179)

  • Corrigido o problema em que a ferramenta Saída do OneDrive não conseguia ler arquivos YXDB com dados DateTime. (TPM-1100)

  • Corrigido o problema em que a ferramenta Saída do OneDrive falha quando o fluxo de trabalho inclui dados dos tipos Byte e Int16. (TPM-209)

v2.2.0

  • Compatível com o Designer 2021.4.2 Patch 4, 2022.1 Patch 2 e versões posteriores.

  • Compatível apenas com AMP Engine.

  • Adicionado suporte para DCM.

    • O DCM é necessário para executar este conector no Alteryx Server.

  • Capaz de operar com FIPS.

  • Opção adicional para substituir apenas uma planilha.

  • Alteração do comportamento do campo de nome da planilha a ser excluído dos dados gravados. Opção adicional para manter o campo de nome da planilha.

  • A validação SSL/TLS é agora executada em relação ao Repositório de Certificados do Windows.

v2.1.0

  • A autenticação ocorre usando o navegador do usuário em vez do CEF incorporado no Designer para cumprir políticas de segurança modernas.

v2.0.2

  • Corrigido o problema de perda da configuração da ferramenta no caso de a opção "Fornecer informações de autenticação" ser habilitada.

v2.0.1

  • Corrigido o problema de tela em branco na autenticação no Designer 2021.3.2.54175. Você também precisa atualizar para o Designer versão 21.3.3.63061 ou posterior.

v2.0.0

  • Aplicativo Azure multilocatário incorporado com uma opção para usar um aplicativo Azure personalizado (incluindo aplicativo de locatário único ou Principal de serviço).

  • Suporte para leitura e gravação de arquivos nos formatos XLSX, CSV e YXDB.

  • Compatível com proxy.

  • Compatível com o Designer versão 2021.2.2 e versões posteriores.

  • Requer o OneDrive 365.

v1.0.2

  • Atualizar opções das Páginas de código.

  • Distinguir entre codificações com o mesmo idioma (por exemplo, 'Language' -> 'Language (specific code)') e codificações organizadas alfabeticamente.

  • Permitir que o usuário especifique a codificação para arquivos CSV na ferramenta de saída.

  • Tratamento de conversão de dados aprimorado para não emitir um aviso em vez de um erro quando está faltando um valor em algum campo.

  • Corrija o problema em que as configurações de valor padrão ocasionalmente não foram respeitadas.

  • Registro em log de produção desativado para impedir problemas de permissões para diferentes instalações/configurações do Designer e oferecer suporte à funcionalidade de fluxo de trabalho agendado.

v1.0.1

  • Corrigido o problema que impedia que os pacotes fossem instalados com sucesso.

v1.0.0

  • Versão inicial para Entrada e Saída do OneDrive.

Aplicativo de API personalizado do Microsoft Azure

Para configurar um aplicativo de API personalizado para essa ferramenta, acesse o nosso guia.

Nota

Certifique-se de ter o AMP Engine habilitado para os fluxos de trabalho que contêm as ferramentas do OneDrive versão 2.2.0 e versões posteriores. Para saber mais, consulte AMP Engine.

Ferramentas do Alteryx usadas para conexão