Compartilhar via


As restrições no Team Foundation de nomeação

Muitos componentes em Visual Studio Team Foundation Server tem certas restrições de nomeação. Essas restrições ajudam a garantir uma experiência de usuário consistente e fornecer compatibilidade com outros programas. Essas restrições podem incluir o comprimento, caracteres especiais, exclusividade ou outros atributos.

This topic contains the following subsections:

Considerações comuns

Restrições de nomes de conta de grupo de Team Foundation Server

Restrições de nomes de computador

Restrições de nomes de coleção de projetos de equipe

Restrições de nomes de projeto de equipe

Restrições de itens de trabalho

Restrições de personalizações de Item de trabalho

Restrições de modelos de processo

Restrições para o Team Foundation Build

Restrições de controle de versão

See Also

Considerações comuns

As restrições de comprimento neste tópico são medidas pelo número de caracteres Unicode que permitido. Para obter mais informações sobre o Unicode, consulte "Sobre o Unicode e conjuntos de caracteres" (https://go.microsoft.com/fwlink/?LinkId=76837). Caracteres substitutos são compostos de dois caracteres Unicode e essas contará como dois caracteres contra a restrição de comprimento.

Como ocorre com outros arquivos do sistema operacional, as combinações de substitutos e caracteres de controle ASCII (ASCII 1-31) também não são permitidas. Para obter informações gerais sobre as restrições do sistema operacional aplicado aos nomes de arquivo, consulte "Nomeação de um arquivo" (https://go.microsoft.com/fwlink/?LinkId=76838).

Restrições de nomes de conta de grupo de Team Foundation Server

Team Foundationcontas de grupo permitem que você aplicar certos direitos ou permissões para um grupo de usuários. Isso Team Foundation group pode consistir em contas de usuário do Windows, contas de grupo do Windows, contas de grupo do Active Directory, Team Foundation contas de grupo, ou qualquer combinação dessas tipos.

Se você deseja criar um grupo que tenha as permissões em vários projetos, consulte Criar um grupo de nível de conjunto. Se você deseja criar um grupo de segurança para o seu projeto de equipe, consulte Criar um grupo de projetos de equipe. Se você quiser adicionar um novo membro a um dos grupos predefinidos por Team Foundation Server, consulte Adicionar usuários a projetos de equipe.

Quando um Team Foundation a conta de grupo é criada ou alterada, ele deve atender a certos Team Foundation Server restrições. A tabela a seguir descreve essas restrições.

Tipo de restrição

Restrição

Comprimento do nome de conta de grupo

  • Não deve conter mais de 256 caracteres Unicode

Exclusividade (contas de grupo de nível de conjunto)

  • Não deve corresponder a qualquer outro nome de uma conta de grupo na coleção de projeto de equipe

Exclusividade (contas de grupo de nível de projeto)

  • Não deve corresponder a qualquer outro nome de grupo no mesmo projeto

Nomes de grupo reservado

  • Não deve ser nomeado $ o NAMESPACE no projeto ou no nível do servidor

Restrições de caracteres especiais

  • Não deve incluir os seguintes caracteres imprimíveis: "/ \ [ ] : | < > + = ; ? *

  • Não deve incluir caracteres não imprimíveis no intervalo de valor ASCII, de 1 a 31

  • Não devem terminar com um ponto (.)

  • Não deve incluir vírgulas ()

ObservaçãoObservação

Você não criar contas de usuário em Team Foundation Server. Em alguns casos, convém adicionar um usuário específico do Windows para um Team Foundation grupo ou para o Team Foundation Server próprio. For more information, see Adicionar um usuário diretamente para um projeto de equipe ou a coleção de projeto de equipe.

Restrições de nomes de computador

Durante a Team Foundation Server o processo de instalação, o nome do computador é associado com o nome da Team Foundation server.

O sistema operacional e Windows Server 2003 do Active Directory impõe certas restrições em nomes de computador. Para obter mais informações sobre como renomear um computador, consulte "Renomear um computador" (https://go.microsoft.com/fwlink/?LinkId=76839). Para obter mais informações sobre o Active Directory, consulte "Windows Server 2003 do Active Directory" (https://go.microsoft.com/fwlink/?LinkId=47541).

Restrições de nomes de coleções de projeto de equipe

O nome de uma coleção de projeto de equipe identifica um agrupamento de projetos de equipe e os recursos que estão associados esses projetos. Uma coleção de projeto de equipe é uma estrutura de organização que você pode usar para definir e controlar um grupo de projetos de equipe dentro de Team Foundation Server. Os membros da equipe usará o nome da coleção de projeto de equipe quando eles se conectam aos projetos de equipe no Team Explorer. Para obter mais informações, consulte Organizando seu servidor com coleções de projeto de equipe.

A tabela a seguir descreve as restrições de nomes de coleções.

Tipo de restrição

Restrição

Length

  • Não deve conter mais de 64 caracteres Unicode

Uniqueness

  • Não deve ser idêntico a qualquer outro nome de coleção na implantação do Team Foundation Server.

  • Se a sua implantação inclui Produtos do SharePoint ou SQL Server Reporting Services, não deve ser idêntico ao nome e caminho completo de um site existente do SharePoint, o servidor de relatório ou site da Web do Reporting Services.

Caracteres especiais

  • Não deve conter caracteres de controle Unicode ou substitutos de caracteres.

  • Não deve conter os seguintes caracteres imprimíveis: / : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ]

  • Não deve conter uma reticências (…) ou um ponto duplo (.)

  • Não deve começar com um sublinhado (_)

  • Não deve iniciar ou terminar com um ponto (.)

Nomes reservados

  • Não deve ser um nome reservado do sistema, como PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON, AUX, Web ou WEB

    Para obter mais informações sobre nomes reservados, consulte esta página no site da Microsoft: Namespaces, caminhos e nomes de arquivo.

Restrições de nomes de projeto

Nomes de projeto em Team Foundation Server identificar uma coleção de itens de trabalho, documentos, relatórios, compilações de equipe e uma árvore de controle de versão que compõem um determinado projeto no Team Foundation. Os membros da equipe usará o nome do projeto para conectar-se ao projeto no Team Foundation Server.

A tabela a seguir descreve as restrições de nomes de projeto.

Tipo de restrição

Restrição

Length

  • Não deve conter mais de 64 caracteres Unicode

Uniqueness

Não deve ser idêntico a nenhum outro nome na coleção de projeto de equipe, o aplicativo da Web do SharePoint que suporta a coleção ou a instância de SQL Server Reporting Services, que oferece suporte a coleção

Caracteres especiais

  • Não deve conter quaisquer caracteres de controle Unicode ou substitutos1 caracteres

  • Não deve conter os seguintes caracteres imprimíveis: / : \ ~ & % ; @ ' " ? < > | # $ * } { , + = [ ]

  • Não deve conter uma reticências (…) ou um ponto duplo (.)

  • Não deve começar com um sublinhado (_)

  • Não deve iniciar ou terminar com um ponto (.)

Nomes reservados

  • Não deve ser um nome reservado do sistema, como PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON ou AUX

  • Para obter mais informações sobre nomes reservados, consulte "Nomeação de um arquivo" (https://go.microsoft.com/fwlink/?LinkId=76838)

1Para obter mais informações sobre caracteres substitutos, consulte "Ask Dr. Internacional, a coluna n º 18 " (https://go.microsoft.com/fwlink/?LinkId=76840).

Restrições de itens de trabalho

Microsoft Visual Studio Application Lifecycle ManagementControla o progresso em um projeto usando os itens como, por exemplo, bugs, requisitos, tarefas e os riscos. Esses itens são chamados genericamente como itens de trabalho. Esta seção descreve as restrições nos dados armazenados em itens de trabalho.

Restrições de anexos de Item de trabalho

Arquivos podem ser anexados aos itens de trabalho. A tabela a seguir descreve as restrições em anexos de item de trabalho.

Tipo de restrição

Restrição

Tamanho do arquivo

  • Por padrão, o limite de tamanho de anexo de arquivo do trabalho item é 4.096 kilobytes. Esse valor pode ser alterado pelo Team Foundation administrador. O tamanho máximo que pode ser definido pelo administrador é 2 gigabytes.

  • Tamanho padrão: 4.096 kilobytes

  • Tamanho máximo: 2 gigabytes

Restrições de áreas de Item de trabalho e iterações

Os itens de trabalho contêm um campo para Project Area e um campo para Iteração do projeto. Eles são usados para organizar e exibir itens de trabalho em agrupamentos lógicos.

O Project Area e Iteração do projeto são caminhos compostos de vários itens de nó, separados por caracteres de barra invertida (\). Nós são definidos pelo Team Foundation Server o administrador para refletir as áreas de projeto e o ciclo do projeto. A tabela a seguir descreve as restrições em nós e os caminhos.

Tipo de restrição

Restrição

Comprimento do nó

  • Não deve conter mais de 255 caracteres

Caracteres especiais para nós

  • Não deve conter caracteres de controle Unicode

  • Não pode conter qualquer um dos seguintes caracteres: \ / $ ? * : " & > < # % |

  • Não deve conter caracteres proibidos por sistema de arquivos local. Para obter mais informações sobre restrições de caracteres do Windows, consulte "Nomeação de um arquivo" (https://go.microsoft.com/fwlink/?LinkId=76838)

Nomes reservados

  • Não deve consistir apenas de um ponto (.) ou dois pontos (.)

  • Não deve ser um nome reservado do sistema, como PRN, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, COM10, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, NUL, CON ou AUX

  • Para obter mais informações sobre nomes reservados, consulte "Nomeação de um arquivo" (https://go.microsoft.com/fwlink/?LinkId=76838)

Comprimento de caminho

  • Não deve conter mais de 4000 caracteres de Unicode

Profundidade de hierarquia do caminho

  • Não deve ser a mais de 14 níveis de profundidade

Restrições de personalizações de Item de trabalho

Team Foundation ServerControla o progresso em um projeto usando os itens como, por exemplo, bugs, requisitos, tarefas e os riscos. Esses itens são chamados genericamente como itens de trabalho.

Os administradores de projetos de equipe podem decidir alterar definições de tipo de item de trabalho no nível do projeto ou em um modelo de processo. Para obter mais informações sobre como personalizar os tipos de item de trabalho, consulte Personalizando o controle de dados, formulários, fluxo de trabalho e outros objetos do projeto. Esta seção descreve as restrições que você encontrará ao personalizar itens de trabalho e seus elementos associados.

Restrições de nomes de campos de Item de trabalho

Cada tipo de item de trabalho contém um ou mais campos de item de trabalho. Esses campos definem as informações armazenadas em um tipo de item de trabalho. Um nome de campo do item de trabalho identifica exclusivamente cada campo do item de trabalho.

A tabela a seguir descreve as restrições de nomes de campos de item de trabalho.

Tipo de restrição

Restrição

Length

Não deve conter mais de 128 caracteres Unicode

Caracteres especiais

  • Não deve conter espaços à direita ou à esquerda

  • Não deve conter dois ou mais espaços consecutivos

  • Não deve conter pontos (.)

  • Não deve conter a abertura ou fechamento de colchetes ([])

Scope

  • Escopo de nomes de campos de item de trabalho para todo o Team Foundation server. Se um nome de campo for alterado, a alteração será refletida em todos os projetos e os tipos de item de trabalho que contenham esse campo de item de trabalho.

Restrições de nomes de referência de campo de Item de trabalho

Cada campo do item de trabalho tem um nome de referência do campo associado. O nome de referência de campo exclusivamente identifica cada campo e não pode ser alterado depois que ele é atribuído. Para obter mais informações sobre nomes de referência de campo, consulte Field Reference Names. A tabela a seguir descreve as restrições aplicadas aos nomes de referência de campo.

Tipo de restrição

Restrição

Length

  • Não deve conter mais de 70 caracteres do Unicode

Caracteres especiais

  • Não deve conter hífens (-)

  • Deve conter pelo menos um ponto (.)

  • Não deve iniciar ou terminar com um ponto (.)

  • Não devem começar com um número.

  • Não deve começar com um sublinhado (_)

Uniqueness

  • Não deve ser idêntico a nenhum outro nome de referência de campo emTeam Foundation Server

  • Não deve ser idêntico a outro nome de referência de campo depois que esses nomes são processados pelo computador para substituir todos os pontos (.) com sublinhados (_)

    Por exemplo, os nomes de referência do campo Minhas ._field e My_.Campo poderia ser processados pelo computador para ser o mesmo nome: My__Field

Texto de ajuda de restrições para o campo de Item de trabalho

Como opção, você pode associar o texto de ajuda com campos de item de trabalho usando o <HELPTEXT> marca. O sistema exibe este texto em tempo de execução para ajudar os usuários a saber o que inserir o campo. Para obter mais informações sobre o texto de ajuda de campo de item de trabalho, consulte Definir o texto de ajuda para um campo de Item de trabalho.

A tabela a seguir descreve as restrições para o texto de ajuda de campo de item de trabalho.

Tipo de restrição

Restrição

Length

  • Não deve conter mais de 255 caracteres Unicode

Scope

Ao contrário do nome do campo e tipo de campo, o texto de Ajuda do campo escopo é um tipo de item de trabalho específico em um projeto de equipe específico.

Restrições de listas globais

Uma lista global é um conjunto de valores de item de lista que são armazenadas e usadas globalmente por todos os Team Foundation servidores em um Team Foundation Server de implementação. Conforme você define os tipos de item de trabalho, você pode descobrir que alguns campos de item de trabalho compartilham o mesmo conjunto de valores possíveis. Listas globais permitem que você definir esses valores de uma vez e compartilhá-los entre vários tipos de item de trabalho. For more information, see Definir listas globais.

Uma lista global (GLOBALLIST) contém um ou mais itens de lista (LISTITEM elementos).

A tabela a seguir descreve as restrições em itens de lista.

Tipo de restrição

Restrição

Length

  • Não deve conter mais de 254 caracteres do Unicode

  • Não deve estar vazio

Caracteres especiais

  • Não deve conter espaços em branco à direita ou à esquerda

  • Não deve conter dois espaços consecutivos

  • Não deve conter o caractere de barra invertida (\)

Scope

  • Como listas globais estão disponíveis entre todos os projetos, eles não devem conter elementos definidos no nível do projeto, tais como definições de conta do grupo de projeto específico.

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

Lista global não deve estar vazia. Ele deve conter pelo menos um LISTITEM elemento.

Uniqueness

  • O nome da lista global não deve ser idêntico a nenhum outro nome na lista global Team Foundation Server.

Restrições de modelos de processo

Um modelo de processo é um conjunto de itens de trabalho padrão, o item de trabalho consultas, os modelos de produto, relatórios, grupos de segurança e orientação que influencia a estrutura de um projeto em Team Foundation. Team Foundation Serverinclui dois modelos de processo padrão que englobam os dois estilos diferentes para gerenciar o ciclo de software. Esses modelos podem ser personalizados para refletir as necessidades exclusivas de sua organização. For more information, see Personalizando modelos de processo.

A tabela a seguir descreve as restrições sobre 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 do nome de modelo de processo

  • Deve ser exclusivo entre os Team Foundation server.

  • Se você carregar um modelo com o mesmo nome de um modelo existente, o modelo existente será substituído.

Tamanho do arquivo de modelo de processo

O tamanho de arquivo de modelo de processo não deve exceder 2 GB (gigabytes).

Restrições para o Team Foundation Build

Team Foundation Buildpermite gerenciar todos os aspectos do processo de compilação em um único computador. Usando Team Foundation Build, você pode sincronizar as fontes, compilar o aplicativo, executar testes de unidade associado, realizar análises de código, versão se baseia em um servidor de arquivo e publicar relatórios de compilação.

Criar restrições de computador

Team Foundation Buildé uma instalação separada da Team Foundation Server camada de aplicativo, a camada de dados, ou Visual Studio do cliente. Você pode designar um computador separado. Caso contrário, você pode instalar a build 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 causará falha compilações).

Construir diretório

Deve ser um caminho local (por exemplo, C:\builddirectory).

Diretório de local de recebimento

Deve ser um caminho UNC (por exemplo, \\servidor\compartilhamento).

Solte as permissões do local

Cada compilação gerada é colocada em uma nova pasta na pasta drop.

  • O Team Foundation Server conta de serviço (por exemplo, domínio\TFSSERVICE) deve ter a permissão de acesso controle total para o local de destino UNC.

  • O local de destino UNC deve ser uma pasta compartilhada.

Conta de serviço do Foundation Build equipe

Se você alterar o Team Foundation Server a conta de serviço após a instalação inicial, você deve certificar-se de que as seguintes condições são true.

  • A conta é membro do grupo de serviços de compilação.

  • A conta tem permissões de leitura/gravação para as pastas temporárias e o ASP.NET uma pasta temporária.

  • A conta tem a permissão Full Control para o local de diretório e soltar de compilação.

Problemas de firewall

Se o computador de compilação é um firewall habilitado, certifique-se de que o programa tfsbuildservice está na lista de exceções.

Nomes de tipo de compilação

Team Foundation Buildusa cria tipos 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 conduzir uma compilação, você deve criar um novo tipo de compilação ou usar um tipo de compilação existente. Para obter mais informações sobre tipos de compilação, consulte Criar e trabalhar com definições de compilação.

A tabela a seguir descreve as restrições em nomes de tipo de compilação.

Tipo de restrição

Restrição

Uniqueness

Não deve ser igual a qualquer outro nome de tipo de compilação do projeto

Caracteres especiais

  • Não deve conter o caractere imprimível: $

Nomes de qualidade de compilação

A qualidade da compilação permite anexar um estado de conclusão ou nível de qualidade para uma compilação concluída. Team Foundation Buildtambém permite que você crie novos valores para o tipo de compilação de qualidade. For more information, see Criar uma definição de compilação básico. Para obter uma lista do padrão, crie valores de qualidade, consulte Avalia a qualidade de uma compilação concluída.

A tabela a seguir descreve as restrições em nomes de qualidade da compilação.

Tipo de restrição

Restrição

Length

Não deve conter mais de 256 caracteres Unicode

Uniqueness

Não deve ser o mesmo como qualquer outro nome de qualidade de construir o Team Foundation Build computador

Restrições de controle de versão

Team Foundationcontrole de versão fornece um repositório central para arquivos e os comandos que são necessários para gerenciar esses arquivos em uma equipe. Ele também fornece diretivas de check-in personalizáveis, ramificação, mesclagem, estantes e muitos outros recursos.

Caminhos do servidor de controle de versão

O caminho de servidor de controle de versão é o local de caminho totalmente qualificado de um arquivo armazenado no controle de versão.

A tabela a seguir descreve as restrições no comprimento do caminho de servidor de controle de versão.

Tipo de restrição

Restrição

Length

  • Não deve conter mais de 248 caracteres de Unicode para um diretório.

  • Não deve conter mais de 260 caracteres do Unicode para um nome de diretório e arquivo combinado.

Adição de arquivos no controle de versão

O sistema de controle de versão armazena muitos tipos diferentes de arquivos. Para obter mais informações sobre como adicionar existentes Visual Studio projetos ou soluções no controle de versão, consulte Colocando arquivos sob controle de versão. Você também pode adicionar arquivos ou pastas que não estão associadas com um Visual Studio projeto ou solução. For more information, see Adicionar pastas ou arquivos de solução não e não-projeto ao controle de versão.

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

Extensões de arquivo

  • Não deve conter os seguintes caracteres imprimíveis: / \ : * ? " < > |

Folders

  • Não deve estar vazio

  • Não deve conter os arquivos que possuem alterações pendentes

  • Não deve residir fora do diretório mapeado para o espaço de trabalho ativo

Nomes de rótulo

Em Team Foundation um rótulo de controle de versão é um nome aplicado a um conjunto específico de revisões. Você pode anexar os rótulos a um conjunto de arquivos não relacionados no controle de versão. Isso lhe permite recuperar os arquivos ou agi-los como um grupo. For more information, see Usar rótulos para tirar um instantâneo dos seus arquivos. A tabela a seguir descreve as restrições de colocar em nomes de rótulo.

Tipo de restrição

Restrição

Length

Não deve conter mais de 64 caracteres Unicode

Caracteres especiais

  • Não pode terminar com um espaço () ou um ponto (.)

  • Não deve conter os seguintes caracteres imprimíveis: " / : < > \ | * ? @

Shelvesets

Shelvesets permitem que você reserve temporariamente um lote de alterações pendentes e, como opção, remova as alterações pendentes da sua área de trabalho. Posteriormente, você pode restaurar as alterações em um shelveset seu espaço de trabalho ou colocá-los na área de trabalho do usuário. For more information, see Trabalhando com Shelvesets.

A tabela a seguir descreve as restrições em nomes de shelveset.

Tipo de restrição

Restrição

Length

Não deve conter mais de 64 caracteres Unicode

Caracteres especiais

  • Não deve conter os seguintes caracteres imprimíveis: " / : < > \ | * ? ;

Nomes de espaço de trabalho

Um espaço de trabalho é uma cópia do lado do cliente de arquivos e pastas em Controle de versão do Team Foundation. Quando você cria vários espaços de trabalho, você pode ter diferentes versões da mesma pasta de controle de versão em um computador cliente. Para obter mais informações sobre espaços de trabalho, consulte Configurar a sua máquina de desenvolvimento para trabalhar com projeto do sua equipe. A tabela a seguir descreve as restrições em nomes de espaço de trabalho.

Tipo de restrição

Restrição

Length

Não deve conter mais de 64 caracteres Unicode

Caracteres especiais

  • Não pode terminar com um espaço)

  • Não deve conter os seguintes caracteres imprimíveis: " / : < > \ | * ? ;

Consulte também

Tarefas

Criar um grupo de nível de conjunto

Criar um grupo de projetos de equipe

Adicionar usuários a um grupo padrão

Adicionar um usuário diretamente para um projeto de equipe ou a coleção de projeto de equipe

Criar uma definição de compilação básico

Avalia a qualidade de uma compilação concluída

Adicionar pastas ou arquivos de solução não e não-projeto ao controle de versão

Conceitos

Personalizando o controle de dados, formulários, fluxo de trabalho e outros objetos do projeto

Definir o texto de ajuda para um campo de Item de trabalho

Definir listas globais

Usar rótulos para tirar um instantâneo dos seus arquivos

Trabalhando com Shelvesets

Configurar a sua máquina de desenvolvimento para trabalhar com projeto do sua equipe

Outros recursos

Personalizando modelos de processo

Criar e trabalhar com definições de compilação

Colocando arquivos sob controle de versão

Field Reference Names

Histórico de alterações

Date

History

Motivo

Dezembro de 2010

Obter informações atualizadas sobre as restrições em nomes de shelvesets e espaços de trabalho.

Comentários do cliente.

Outubro de 2010

Informações atualizadas sobre a exclusividade necessária para nomes de projetos de equipe.

Comentários do cliente.