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

Notas de versão do Conector 1.0.0 (Python)

Compatibilidade com o Designer (a ser discutida)

O que há de novo

Novos recursos!
The Box connector defaults Time and DateTime precision to milliseconds to avoid extra trailing zeros, while still supporting nanosecond resolution when required by the workflow.

Alterações no comportamento

We've disabled the right-click context menu in Designer for the Box tools to prevent unintended actions.

Problemas corrigidos

Corrigido Versão de lançamento do Conector xxxx.x.x.xxxxx
ID	Descrição
TPM-5038	Newly created files in the Box tools inherit the previously selected filename when saved with any extension.
TPM-5006	Selecting Enable Dry Run in the Box Input tool (version 2.5.6) using a DCM connection with JWT authentication causes an error.
TPM-4984	The Box connector version 2.5.7 doesn’t recognize YXDB files.
TPM-4948	An error occurs when uploading a file using the Box tools.
TPM-4853	Special characters in the proxy password cause an error when setting up a manual proxy server for the Box tools.
TPM-4782	Secret values are exposed in the returned JSON in the Designer HTML Developer Tools for the Box tools.
TPM-4754	The Box Input tool returns a "list index out of range" error.
TPM-4645	The Box DCM connection returns an invalid access token error after 24 hours.
TPM-4396	The Box Input tool doesn’t function properly with DCM.
TPM-4239	The SharePoint Input (version 2.4.2) and Box Input (version 2.5.2) tools don’t return metadata for YXDB files that contain only a heading row.
TPM-4192	File name breadcrumbs don’t appear correctly in the Box UI.
TPM-4191	The Box Input tool version 2.5.6 on Python 3.10 adds extra decimal values to datetime fields.
TPM-3832	The SharePoint Input tool version 2.6.2 returns a "Python int too large to convert to C long" error.
TPM-3334	After upgrading to SDK version 2.4.0, null datetime values appear as NaT in CSV files using the Box tools.
TPM-3266	The SharePoint Input (version 2.4.2) and Box Input (version 2.5.2) tools don’t return metadata for CSV and XLSX files that contain only a heading row.

Problemas conhecidos

Conhecido Versão de lançamento do Conector xxxx.x.x.xxxxx
JIRA-ID	Descrição do problema

Conhecido

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

Descrição

JIRA-ID

Descrição do problema

Problemas cancelados

Cancelado Versão de lançamento do Conector xxxx.x.x.xxxxx
ID	Descrição
TPM-4190	The dry run feature doesn’t work in the Box Input tool version 2.5.6.
TPM-4049	The Box Output tool returns errors when writing large XLSX files.
TPM-3758	The Box Output tool doesn’t retain selected fields as expected.
TPM-3634	File paths don’t update when files are deleted from the Box server using a browser.
TPM-3479	In Box version 2.5.5 (Python 3.8), using the 'Download file locally for later processing' feature with an empty or invalid location doesn’t work as expected in either scenario.
TPM-3477	INT data types upload as FLOAT types when viewed in the Box browser.
TPM-3435	The Box Output tool maps incorrect data types for XLSX files.
TPM-2871	The Box DCM connection returns an invalid access token error after 24 hours.
TPM-2792	The Box Input tools return a "Communication error: Failed to write Control In message" during validation.
TPM-2267	The Box Output tool writes an empty YXDB file if a field is of the DateTime data type.
TPM-2246	The Box Output tool displays an unclear error message for invalid CSV files.
TPM-2133	Field names are not automatically voiced in the Box tools.
TPM-1568	The Box tools experience a significant lag when users click away from the tool.

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


Ferramenta Entrada do Box	Ferramenta Saída do Box

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

Faça login em https://alteryx.app.box.com/developers/console usando suas credenciais do Box.
Clique em Criar novo aplicativo.
Selecione Aplicativo personalizado.
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.
Na guia Configuração em Escopos de aplicativo, selecione Gravar todas as pastas e arquivos armazenados no Box para fornecer permissão ao aplicativo.
Selecione Salvar alterações.
Para gerar um novo token de desenvolvedor, clique em Revogar, depois, em Gerar token de desenvolvedor.
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:

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.
2. Insira file://* em Origens permitidas.
Aplicativo Box com token de acesso e autenticação JWT:
1. Insira file://* em Origens permitidas.

Nesta secção:

Box