Restrições de nomenclatura no Team Foundation
Vários componentes no Visual Studio Team Foundation Server (TFS) possuem restrições de nomenclatura. Essas restrições ajudam a garantir uma experiência de usuário consistente e fornecer compatibilidade com outros programas. Entre as restrições estão comprimento, caracteres especiais, exclusividade ou outros atributos.
Este tópico contém as seguintes subseções:
Servidor, coleta, conta, grupo e restrições de nome do computador:
|
Item de projeto e trabalho restrições de nome de controle:
|
Restrições de compilação e o nome de código:
|
Considerações comuns
As restrições de comprimento neste tópico são medidas pelo número de caracteres Unicode permitidos. Para saber mais sobre Unicode, veja “Sobre Unicode e conjuntos de caracteres” (https://go.microsoft.com/fwlink/?LinkId=76837). Os caracteres alternativos são formados por dois caracteres Unicode e serão contados como dois caracteres com relação à restrição de comprimento.
Como em outros arquivos do sistema operacional, os caracteres de controle ASCII (ASCII 1-31) e as combinações alternativas também não são permitidos. Para informações gerais sobre as restrições do sistema operacional aplicadas a nomes de arquivo, confira Nomeando arquivos, caminhos e namespaces.
Restrições para nomes de conta do Team Foundation Server
As contas de usuário identificam os usuários no TFS. Essas contas podem ser contas de usuário do Windows, contas do Active Directory ou outros tipos de contas. Para exemplos de como adicionar um usuário aos grupos usados no TFS, em Produtos do SharePoint e no SQL Server Reporting Services, veja Adicionar usuários a projetos da equipe.
Quando um usuário é adicionado ao TFS, o nome de usuário deve obedecer a determinadas restrições do Team Foundation Server. A tabela a seguir descreve essas restrições.
Tipo de restrição |
Restrição |
---|---|
Comprimento do nome da conta |
|
Exclusividade |
|
Nomes de grupos reservados |
|
Restrições de caracteres especiais |
|
Dica
É possível adicionar contas de usuários existentes no Team Foundation Server.Não é possível criar uma conta de usuário no TFS.
Restrições para nomes de contas de grupo do Team Foundation Server
É possível aplicar determinados direitos ou permissões a um grupo de usuários nas contas de grupo do Team Foundation. Esse grupo do Team Foundation pode ser formado por contas de usuários do Windows, contas de grupos do Windows, contas de grupos do Active Directory, contas de grupos do Team Foundation ou qualquer combinação desses tipos. Para obter mais informações sobre como gerenciar usuários, grupos, consulte usuários, grupos e permissões em implantações do Team Foundation Server e Gerenciar usuários ou grupos no TFS. Se você desejar exemplos de como adicionar um novo membro a grupos usados no TFS, em Produtos do SharePoint e no SQL Server Reporting Services, confira Adicionar usuários a projetos da equipe.
Ao criar ou alterar uma conta de grupo do Team Foundation, ela deve obedecer a determinadas restrições do Team Foundation Server. A tabela a seguir descreve essas restrições.
Tipo de restrição |
Restrição |
---|---|
Comprimento do nome da conta de grupo |
|
Exclusividade (contas de grupos no nível de coleção) |
|
Exclusividade (contas de grupos no nível de projeto) |
|
Nomes de grupos reservados |
|
Restrições de caracteres especiais |
|
Dica
Não é possível criar contas de usuário no Team Foundation Server.
Restrições para nomes de computadores
Durante o processo de instalação do TFS, o nome do computador é associado ao nome do servidor.
Tanto o sistema operacional quanto o Active Directory impõem determinadas restrições aos nomes de computadores. Para saber mais sobre como renomear um computador, veja “Renomear um computador” (https://go.microsoft.com/fwlink/?LinkId=76839). Para saber mais sobre o Active Directory, veja “Windows Server 2003 Active Directory” (https://go.microsoft.com/fwlink/?LinkId=47541).
Restrições para nomes de coleções de projetos de equipe
O nome de uma coleção de projetos de equipe identifica um agrupamento de projetos de equipe e os recursos que estão associados a esses projetos. Uma coleção de projetos de equipe é uma estrutura de organização que pode ser usada para definir e controlar um grupo de projetos de equipe dentro do TFS. Os membros da equipe usarão o nome da coleção de projetos de equipe quando se conectarem a projetos de equipe no TFS. Para saber mais, veja Gerenciar coleções de projetos da equipe.
A tabela a seguir descreve as restrições para nomes de coleções.
Tipo de restrição |
Restrição |
---|---|
Comprimento |
|
Exclusividade |
|
Caracteres especiais |
|
Nomes reservados |
|
Restrições para nomes de projetos
Os nomes de projetos no TFS identificam uma coleção de itens de trabalho, documentos, relatórios, compilações de equipe e uma árvore de controle de versão de um determinado projeto no TFS. Os membros de equipe usarão esse nome de projeto para se conectarem ao projeto no TFS.
A tabela a seguir descreve as restrições para nomes de projetos.
Tipo de restrição |
Restrição |
---|---|
Comprimento |
|
Exclusividade |
Não deve ser idêntico a nenhum outro nome na coleção de projetos de equipe, ao aplicativo Web do SharePoint que oferece suporte à coleção ou à instância do SQL Server Reporting Services que oferece suporte à coleção |
Caracteres especiais |
|
Nomes reservados |
|
Restrições para nomes de equipes
Nomes de equipe do TFS identificam um grupo de indivíduos ou grupos que trabalham coletivamente com uma equipe em um projeto. Os membros de equipe usarão esse nome de projeto para se conectarem à equipe no TFS. O nome da equipe deve poder ser renderizado como parte de uma URL válida. Além disso, cada nome de equipe deve ser exclusivo dentro de um único projeto, mas não há restrições sobre o uso do mesmo nome de equipe em projetos diferentes dentro de uma coleção de projetos de equipe. Para obter mais informações sobre como trabalhar em equipes, consulte Adicionar outra equipe ou uma hierarquia de equipes.
A tabela a seguir descreve as restrições para nomes de equipes.
Tipo de restrição |
Restrição |
---|---|
Comprimento |
|
Exclusividade |
Não deve ser idêntico a nenhum outro nome no projeto |
Caracteres especiais |
|
Nomes reservados |
|
Restrições para itens de trabalho
O gerenciamento do ciclo de vida de aplicativos do Microsoft Visual Studio acompanha o andamento de um projeto usando itens, tais como bugs, requisitos, tarefas e riscos. Esses itens são chamados genericamente de itens de trabalho. Esta seção descreve as restrições sobre os dados armazenados nos itens de trabalho.
Restrições para anexos de itens de trabalho
É possível anexar arquivos aos itens de trabalho. A tabela a seguir descreve as restrições para os anexos de itens de trabalho.
Tipo de restrição |
Restrição |
---|---|
Tamanho de arquivo |
|
Restrições para áreas e iterações de itens de trabalho
Os itens de trabalho contêm um campo para Área de Projeto e um para Iteração de Projeto. Eles são usados para organizar e exibir itens de trabalho em agrupamentos lógicos.
A Área de Projeto e a Iteração de Projeto são caminhos formados por vários itens de nós separados por caracteres de barra invertida (\). Os nós são definidos pelo administrador do Team Foundation Server para refletir as áreas e o ciclo do projeto. A tabela a seguir descreve as restrições para nós e caminhos.
Tipo de restrição |
Restrição |
---|---|
Comprimento do nó |
|
Caracteres especiais para nós |
|
Nomes reservados |
|
Comprimento do caminho |
|
Profundidade da hierarquia do caminho |
|
Restrições para personalizações de itens de trabalho
O Team Foundation Server acompanha o andamento de um projeto usando itens, tais como bugs, requisitos, tarefas e riscos. Esses itens são chamados genericamente de itens de trabalho.
Os administradores de projetos de equipe podem decidir alterar as definições de tipos de itens de trabalho no nível do projeto ou em um modelo de processo. Para saber mais sobre como personalizar tipos de itens de trabalho, confira Personalizar objetos de acompanhamento de trabalho para dar suporte aos processos da sua equipe. Esta seção descreve as restrições que você encontrará ao personalizar os itens de trabalho e seus elementos associados.
Restrições para nomes de campos de itens de trabalho
Cada tipo de item de trabalho contém um ou mais campos de itens de trabalho. Esses campos definem as informações armazenadas em um tipo de item de trabalho. Um nome de campo de item de trabalho identifica com exclusividade cada campo de item de trabalho.
A tabela a seguir descreve as restrições para nomes de campos de itens de trabalho.
Tipo de restrição |
Restrição |
---|---|
Comprimento |
Não deve conter mais de 128 caracteres Unicode |
Caracteres especiais |
|
Escopo |
|
Restrições para nomes de referência de campo de item de trabalho
Cada campo de item de trabalho possui um nome de referência de campo associado. O nome de referência do campo identifica com exclusividade cada campo e não pode ser alterado após sua atribuição. A tabela a seguir descreve as restrições aplicadas aos nomes de referência de campos.
Tipo de restrição |
Restrição |
---|---|
Comprimento |
|
Caracteres especiais |
|
Exclusividade |
|
Restrições para texto de ajuda do campo de item de trabalho
Como alternativa, você pode associar o texto de ajuda a campos de itens de trabalho usando a marca <HELPTEXT>. O sistema exibe esse texto no tempo de execução para ajudar os usuários a saber o que devem inserir no campo. For more information about work item field help text, see Aplicar uma regra a um campo do item de trabalho.
A tabela a seguir descreve as restrições para texto de ajuda do campo de item de trabalho.
Tipo de restrição |
Restrição |
---|---|
Comprimento |
|
Escopo |
Diferente do nome do campo e do tipo de campo, o texto de ajuda do campo tem escopo para um tipo de item de trabalho específico em um projeto de equipe específico. |
Restrições para listas globais
Uma lista global é um conjunto de valores de itens de lista que é armazenado e usado globalmente por todos os servidores do Team Foundation em uma implantação do Team Foundation Server. À medida que você define os tipos de itens de trabalho, será possível descobrir que alguns campos de itens de trabalho compartilham o mesmo conjunto de valores possível. As listas globais permitem definir esses valores uma vez e compartilhá-los entre vários tipos de itens de trabalho. Para obter mais informações, consulte Definir listas globais.
Uma lista global (GLOBALLIST) contém um ou mais itens de lista (elementos LISTITEM).
A tabela a seguir descreve as restrições para os itens de lista.
Tipo de restrição |
Restrição |
---|---|
Comprimento |
|
Caracteres especiais |
|
Escopo |
|
A tabela a seguir descreve as restrições que se aplicam a uma lista global.
Tipo de restrição |
Restrição |
---|---|
Número de itens |
A lista global não deve estar vazia. Ela deve apresentar pelo menos um elemento LISTITEM. |
Exclusividade |
|
Restrições para modelos de processo
Um modelo de processo é um conjunto de itens de trabalho padrão, consultas de itens de trabalho, modelos de produto, relatórios, grupos de segurança e orientação que influencia a estrutura de um projeto no Team Foundation. O Team Foundation Server inclui dois modelos de processo padrão que envolve dois estilos diferentes para gerenciar o ciclo de software. Esses modelos podem ser personalizados para refletir as necessidades exclusivas de sua organização. Para obter mais informações, consulte Personalizar um modelo de processo.
A tabela a seguir descreve as restrições para os modelos de processo.
Tipo de restrição |
Restrição |
---|---|
Comprimento do nome do modelo de processo |
Não deve conter mais de 256 caracteres Unicode. |
Exclusividade no nome do modelo de processo |
|
Tamanho do arquivo de modelo de processo |
O tamanho do arquivo de modelo de processo não deve exceder 2 GB (gigabytes). |
Restrições do Team Foundation Build
O Team Foundation Build permite gerenciar todos os aspectos do processo de compilação em um único computador. Com o uso do Team Foundation Build, é possível sincronizar as fontes, compilar o aplicativo, executar testes de unidades associadas, realizar análise de código, liberar compilações em um servidor de arquivos e publicar relatórios de compilação.
Restrições para computadores de compilação
O Team Foundation Build é uma instalação separada da camada de aplicativo do Team Foundation Server, da camada de dados ou do cliente do Visual Studio. Você pode designar um computador separado. Caso contrário, poderá instalar a compilação lado a lado no computador cliente ou nos servidores.
A tabela a seguir descreve as restrições para o computador de compilação.
Tipo de restrição |
Restrição |
---|---|
Espaço em disco |
Deve conter espaço suficiente para a compilação (espaço insuficiente resultará em compilações com falha). |
Diretório de compilação |
Deve ser um caminho local (por exemplo, C:\builddirectory). |
Diretório do local de destino |
Deve ser um caminho UNC (por exemplo, \\server\share). |
Permissões do local de destino |
Cada compilação gerada é colocada em um novo diretório na pasta de destino.
|
Conta do Team Foundation Build Service |
Se você alterar a conta do TFS Service após a instalação inicial, verifique se as condições a seguir se aplicam.
|
Problemas com firewall |
Se o computador de compilação estiver com o firewall habilitado, verifique se o programa tfsbuildservice está na lista de exceções. |
Nomes de tipos de compilação
O Team Foundation Build usa tipos de compilação para configurar as condições sob as quais uma única solução ou um conjunto de soluções em um projeto de equipe será compilado. Para realizar uma compilação, crie um novo tipo de compilação ou use um tipo de compilação existente. Para saber mais sobre tipos de compilação, confira Definir o processo de compilação.
A tabela a seguir descreve as restrições para os nomes de tipos de compilação.
Tipo de restrição |
Restrição |
---|---|
Exclusividade |
Não deve ser idêntico a nenhum outro nome de tipo de compilação no projeto |
Caracteres especiais |
|
Nomes da qualidade de compilação
A qualidade de compilação permite anexar um nível de qualidade ou um estado de conclusão a uma compilação concluída. O Team Foundation Build permite também criar novos valores para o tipo de qualidade de compilação. Para obter mais informações, consulte Criar ou editar uma definição de compilação. Para ver uma lista de valores de qualidade de compilação padrão, confira Classificar a qualidade de uma compilação concluída.
A tabela a seguir descreve as restrições para os nomes da qualidade de compilação.
Tipo de restrição |
Restrição |
---|---|
Comprimento |
Não deve conter mais de 256 caracteres Unicode |
Exclusividade |
Não deve ser idêntico a nenhum outro nome de Qualidade de compilação no computador do Team Foundation Build |
Restrições para controle de versão
O controle de versão do Team Foundation fornece um repositório central para arquivos e os comandos necessários para gerenciar esses arquivos em uma equipe. Ele fornece também opções personalizáveis de políticas de check-in, ramificação, mesclagem, check-in particular e muitos outros recursos.
Caminhos de controle de versão
A tabela a seguir descreve as restrições para um caminho de controle de versão.
Tipo de restrição |
Restrição |
---|---|
Comprimento do caminho da pasta do controle do código-fonte do servidor |
|
Comprimento do caminho da pasta local |
|
Confira também: Otimizar seu espaço de trabalho.
Adicionar arquivos ao controle de versão
O sistema de controle de versão armazena vários tipos de arquivos diferentes. Para saber mais sobre como adicionar projetos ou soluções existentes do Visual Studio ao controle de versão, confira Configurar o controle de versão do Team Foundation na sua máquina de desenvolvimento.
A tabela a seguir descreve as restrições aplicadas a arquivos e pastas a serem adicionados ao controle de versão.
Tipo de restrição |
Restrição |
---|---|
Arquivos e pastas |
|
Nomes de arquivo |
|
Nomes dos rótulos
No controle de versão do Team Foundation, um rótulo é um nome aplicado a um conjunto específico de revisões. Você pode anexar rótulos a um conjunto de arquivos não relacionados no controle de versão. Isso permite recuperar os arquivos ou trabalhar com eles como um grupo. A tabela a seguir descreve as restrições para os nomes dos rótulos.
Tipo de restrição |
Restrição |
---|---|
Comprimento |
Não deve conter mais de 64 caracteres Unicode |
Caracteres especiais |
|
Check-ins particulares
Os check-ins particulares permitem reservar temporariamente um lote de alterações pendentes e, como uma opção, remover as alterações pendentes de seu espaço de trabalho. Posteriormente, você poderá restaurar as alterações em um check-in particular em seu espaço de trabalho ou colocá-las em outro espaço de trabalho de usuário.
A tabela a seguir descreve as restrições para os nomes de check-ins particulares.
Tipo de restrição |
Restrição |
---|---|
Comprimento |
Não deve conter mais de 64 caracteres Unicode |
Caracteres especiais |
|
Nomes de espaços de trabalho
Um espaço de trabalho é uma cópia do lado do cliente dos arquivos e das pastas no Controle de versão do Team Foundation. Ao criar vários espaços de trabalho, você pode ter versões diferentes da mesma pasta de controle de versão em um computador cliente. Para saber mais sobre espaços de trabalho, confira Criar e trabalhar com espaços de trabalho. A tabela a seguir descreve as restrições para os nomes de espaços de trabalho.
Tipo de restrição |
Restrição |
---|---|
Comprimento |
Não deve conter mais de 64 caracteres Unicode |
Caracteres especiais |
|
Consulte também
Tarefas
Criar ou editar uma definição de compilação
Classificar a qualidade de uma compilação concluída
Conceitos
Personalizar objetos de acompanhamento de trabalho para dar suporte aos processos da sua equipe
Personalizar um modelo de processo