Skip to main content

Box

Tipo de conexão

Ferramenta do Alteryx. A versão mais recente está disponível no Alteryx Marketplace.

Tipo de suporte

Leitura e gravação

Notas de versão do Conector 1.0.0 (Python)

Compatibilidade com o Designer (a ser discutida)

Problemas corrigidos

Corrigido

Versão de lançamento do Conector xxxx.x.x.xxxxx

ID

Descrição

TPM-5081

The Box connector version 2.5.7 fails with multiple Box Input tools on Server 25.1 when workflows run in parallel and returns a “Failed to find DCM connection values” error.

Problemas cancelados

Cancelado

Versão de lançamento do Conector xxxx.x.x.xxxxx

ID

Descrição

TPM-4180

The authentication window doesn’t open when refreshing OAuth credentials in the Box tools.

TPM-2621

The Box connector fails to read files larger than 1.9 GB.

8 de dezembro de 2025

Box versão 2.5.7

O que há de novo

  • O Designer exibe uma clara mensagem de aviso quando os usuários inserem um número de planilha, nome de planilha ou intervalo de planilha inválido.

  • O conector do Box padroniza a precisão de hora e data/hora para milissegundos para evitar zeros extras à direita, enquanto ainda oferece suporte à resolução de nanossegundo quando exigido pelo fluxo de trabalho.

Alterações no comportamento

  • Desabilitamos a exibição do menu de contexto ao clicar com o botão direito do mouse no Designer para que as ferramentas do Box impeçam ações não intencionais.

Problemas corrigidos

Corrigido

Box versão 2.5.7

ID

Descrição

TPM-5038

Os arquivos recém-criados nas ferramentas do Box herdam o nome de arquivo selecionado anteriormente quando salvos com qualquer extensão.

TPM-5006

Selecionar "Habilitar simulação (dry-run)" na ferramenta Entrada do Box (versão 2.5.6) usando uma conexão do DCM com autenticação JWT causa um erro.

TPM-4984

O conector do Box versão 2.5.7 não reconhece arquivos YXDB.

TPM-4948

Ocorre um erro ao carregar um arquivo usando as ferramentas do Box.

TPM-4853

Os caracteres especiais na senha do proxy causam um erro ao configurar um servidor proxy manual para as ferramentas do Box.

TPM-4782

Os valores secretos são expostos no JSON retornado nas ferramentas de desenvolvedor HTML do Designer para as ferramentas do Box.

TPM-4754

A ferramenta Entrada do Box retorna um erro "índice da lista fora do intervalo".

TPM-4645

A conexão do DCM do Box retorna um erro de token de acesso inválido após 24 horas.

TPM-4396

A ferramenta Entrada do Box não funciona corretamente com o DCM.

TPM-4239

As ferramentas Entrada do SharePoint (versão 2.4.2) e Entrada do Box (versão 2.5.2) não retornam metadados para arquivos YXDB que contenham apenas uma linha de cabeçalho.

TPM-4192

As trilhas de navegação do nome do arquivo não aparecem corretamente na IU do Box.

TPM-4191

A ferramenta Entrada do Box versão 2.5.6 no Python 3.10 adiciona valores decimais extras aos campos de data e hora.

TPM-3832

A ferramenta Entrada do SharePoint versão 2.6.2 retorna um erro "O inteiro do Python é muito grande para converter em longo do C".

TPM-3334

Depois de atualizar para o SDK versão 2.4.0, valores de data/hora nulos aparecem como NaT em arquivos CSV que usam as ferramentas do Box.

TPM-3266

As ferramentas Entrada do SharePoint (versão 2.4.2) e Entrada do Box (versão 2.5.2) não retornam metadados para arquivos CSV e XLSX que contenham apenas uma linha de cabeçalho.

Problemas conhecidos

Conhecido

Box versão 2.5.7

ID

Descrição

TPM-2621

O conector do Box falha ao ler arquivos maiores que 1.9 GB.

Problemas cancelados

Cancelado

Box versão 2.5.7

ID

Descrição

TPM-4190

O recurso de simulação (dry-run) não funciona na ferramenta Entrada do Box versão 2.5.6.

TPM-4049

A ferramenta Saída do Box retorna erros ao gravar arquivos XLSX grandes.

TPM-3758

A ferramenta Saída do Box não retém os campos selecionados como esperado.

TPM-3634

Os caminhos de arquivo não são atualizados quando os arquivos são excluídos do servidor do Box usando um navegador.

TPM-3479

No Box versão 2.5.5 (Python 3.8), usar o recurso "Baixar arquivo localmente para processamento posterior" com um local vazio ou inválido não funciona como esperado em nenhum dos cenários.

TPM-3477

Os tipos de dados INT carregam como tipos FLOAT quando visualizados no navegador do Box.

TPM-3435

A ferramenta Saída do Box mapeia tipos de dados incorretos para arquivos XLSX.

TPM-2871

A conexão do DCM do Box retorna um erro de token de acesso inválido após 24 horas.

TPM-2792

A ferramenta Entrada do Box retorna um "Erro de comunicação: falha ao gravar o controle na mensagem" durante a validação.

TPM-2267

A ferramenta Saída do Box grava um arquivo YXDB vazio se um campo for do tipo de dados de data/hora.

TPM-2246

A ferramenta Saída do Box exibe uma mensagem de erro pouco clara para arquivos CSV inválidos.

TPM-2133

Os nomes dos campos não são expressos automaticamente nas ferramentas do Box.

TPM-1568

As ferramentas do Box apresentam um atraso significativo quando os usuários clicam fora da ferramenta.

Versão

Descrição

v2.5.6

  • É compatível com o Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Exige o AMP Engine.

  • Corrigido o problema em que a Entrada do Box não conseguia ler dados quando uma coluna do Excel tinha dados de dois tipos. (TPM-4135)

  • Corrigido o problema em que os Tokens Web JSON não funcionavam nas ferramentas do Box. (TPM-4115, TDCE-520)

  • Corrigido o problema em que o SDK do Python não reportava erros do DCM. (TPM-3929)

  • Corrigido o problema em que a Entrada do Box não retinha dados do tipo data. (TDCE-537)

  • Corrigido o problema em que a Saída do Box convertia números em texto. (TDCE-453)

v2.5.5

  • É compatível com o Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Exige o AMP Engine.

  • Removemos o uso da pasta .shiv.

  • Adicionado suporte para Alteryx Designer e Server 2024.1.

  • Problema corrigido em que a ferramenta Entrada do Box era executada indefinidamente quando configurada para ler um conjunto de dados vazio. (TPM-2453)

  • Corrigido o problema em que não era possível conectar as ferramentas do Box a um token JWT recém-gerado. (TFLN-1855)

v2.5.4

  • É compatível com o Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Exige o AMP Engine.

  • Problema corrigido em que a ferramenta Saída do Box não conseguia gravar o tipo de dados fixedDecimal em arquivos YXDB. (TPM-2111)

  • Problema corrigido em que a ferramenta Saída do Box não conseguia substituir certos arquivos grandes do Excel. (TPM-2169)

v2.5.2

  • É compatível com o Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Exige o AMP Engine.

  • Para a ferramenta Entrada do Box, adicionamos uma opção "Incluir subpastas" ao usar a pesquisa com caractere curinga, fazer download de arquivos localmente ou quando o usuário optar por Processar arquivo como.

  • Corrigido o problema de desempenho ao utilizar a pesquisa com caractere curinga na ferramenta Entrada do Box. (TPM-2027)

  • Problema corrigido em que a pesquisa com caractere curinga retornava um erro na primeira vez que o fluxo de trabalho era executado. (TPM-1847)

  • Problema corrigido em que a ferramenta Saída do Box não conseguia gravar vários tipos de dados de número e data/hora em arquivos YXDB. (TDCE-96, TPM-1958)

  • Problema corrigido em que o fluxo de trabalho falhava quando a ferramenta Saída do Box era configurada para usar o campo de entrada para nomear dinamicamente um ou mais arquivos de saída. (TPM-1980)

  • Problema corrigido em que o painel de configuração do Box apresentava erro intermitente quando deixado aberto por um longo período de tempo. (TFLN-1210)

Problema conhecido

  • A ferramenta Saída do Box não consegue gravar o tipo de dados fixedDecimal em arquivos YXDB. (TPM-2111)

O Alteryx Server exige o valor AllowAll das configurações do Modo de Acesso do SDK.

v2.5.1

  • É compatível com o Alteryx Designer e Server 2021.4.2 Patch 6, 2022.1 Patch 4 e versões posteriores.

  • Exige o AMP Engine.

  • Problema corrigido em que a guia Configurar arquivo era reenviada quando os usuários pressionavam "Enter" no campo "Caminho do arquivo". (TFLN-1209)

  • Problema corrigido em que a leitura de um arquivo XLSX com valores nulos resultava em erro. (TDCE-92)

  • Problema corrigido em que um fluxo de trabalho executado com os conectores do Box usando autenticação JWT não eram executados após um dia, com o erro de criptografia ou token de acesso inválido. (TPM-1802)

  • Problema corrigido em que a ferramenta Saída do Box não conseguia agregar dados quando continha caractere delimitador entre aspas. (TDCE-28)

  • Problema corrigido em que a ferramenta Saída do Box não conseguia gravar tipos de dados de data e data/hora, ou mudava a data para 70 anos no futuro. (TPM-1902)

Problema conhecido

  • A ferramenta Saída do Box não consegue gravar vários tipos de dados de número e data/hora em arquivos YXDB (TDCE-96). A solução alternativa é usar dados de saída em CSV ou XLSX.

v2.5.0

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

  • Exige o AMP Engine.

  • Adicionado suporte para DCM.

    • O DCM é obrigatório para executar este conector no Alteryx Server.

  • Adicionada opção para substituir apenas uma planilha adicionada.

  • Alteração do comportamento do campo de nome da planilha e do arquivo a serem excluídos dos dados gravados. Adicionada opção adicional para manter o campo de nome da planilha e do arquivo.

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

  • Capaz de operar com FIPS.

  • Problema corrigido com a nomeação dinâmica de arquivos. (TPM-1688)

Problema conhecido

  • O Alteryx Server exige o valor AllowAll das configurações do Modo de Acesso do SDK.

v2.4.0

  • É compatível com o Alteryx Designer 2021.4.2 e versões posteriores.

  • Agora, as opções "Agregar" e "Substituir" criam uma nova versão do arquivo em vez de excluir o arquivo antigo e criar um novo. Isso preserva o histórico de versões do arquivo e os links compartilhados.

  • Removemos o limite de 100 arquivos baixados de uma única pasta.

v2.3.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.

  • Pequenas correções de bugs.

v2.2.0

  • Adicionada uma opção adicional para passar informações de coluna (nomes de colunas e tipos de dados) para a ferramenta conectada sem a necessidade de executar o fluxo de trabalho.

  • Saída dinâmica adicionada

  • Adicionada uma opção para carregar arquivos locais para o Box usando a ferramenta Saída do Box.

  • A caixa de seleção "Gravar cabeçalhos" agora está habilitada por padrão.

  • Pequenas correções de bugs.

v2.1.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. Um cabeçalho de lista de permissões precisa ser adicionado ao seu aplicativo Box depois da atualização.

v1.0.0

  • Oferece suporte aos métodos de autenticação OAuth (incluindo SSO) e token de acesso.

  • Permite que os usuários baixem as pastas e os arquivos localmente.

  • Requer a versão 2021.3 ou versões posteriores do Designer

Ferramentas do Alteryx usadas para conexão

Use o conector do Box para executar, agendar e publicar fluxos de trabalho do Designer utilizando arquivos armazenados no seu espaço de trabalho do Box. Os tipos de arquivo compatíveis são XLSX, CSV e YXDB.

Cuidado

O Desktop Automation (Scheduler) não é compatível com esse conector.

Gerenciador de Conexões de Dados

As ferramentas do Box 2.5.0 e versões posteriores são compatíveis com o Gerenciador de Conexões de Dados para um armazenamento mais fácil e seguro de suas credenciais. Crie uma conexão com o Box e reutilize facilmente as credenciais armazenadas em fluxos de trabalho que incluem as ferramentas do Box. O Alteryx Server exige credenciais armazenadas para executar com êxito os fluxos de trabalho publicados.

Habilitar o AMP Engine

Certifique-se de ter o AMP Engine habilitado para os fluxos de trabalho que contêm as ferramentas do Box 2.5.0 e versões posteriores para aproveitar todo o potencial dos recursos do Designer.

Registro no aplicativo Box

  1. Faça login em https://alteryx.app.box.com/developers/console usando suas credenciais do Box.

  2. Clique em Criar novo aplicativo.

  3. Selecione Aplicativo personalizado.

  4. Em Método de autenticação, selecione Autenticação de usuário (OAuth 2.0). Insira o Nome do aplicativo e clique em Criar aplicativo.

  5. Na guia Configuração em Escopos de aplicativo, selecione Gravar todas as pastas e arquivos armazenados no Box para fornecer permissão ao aplicativo.

  6. Selecione Salvar alterações.

  7. Para gerar um novo token de desenvolvedor, clique em Revogar, depois, em Gerar token de desenvolvedor.

  8. Você pode usar ID e Segredo do cliente em Credenciais do OAuth 2.0 para autenticação.

Configuração personalizada do aplicativo

Para evitar um problema de CORS do Box ao usar o aplicativo com autenticação OAuth ou token de acesso e JWT, use uma configuração personalizada:

  1. Aplicativo Box com autenticação OAuth:

    1. Adicione o URI de redirecionamento https://cef.alteryx.com/designer/oauthcallback para solucionar o problema de CORS da janela do CEF.

      BoxOAuth
    2. Insira file://* em Origens permitidas.

      BoxOAuthCORS
  2. Aplicativo Box com token de acesso e autenticação JWT:

    1. Insira file://* em Origens permitidas.

      BoxTokensCORS