Compartilhar via

URLs e tokens no SharePoint

  • Artigo

Saiba como formular URLs e usar tokens de URL no SharePoint.

Tipos de URLs no SharePoint

O SharePoint analisa cadeias de caracteres de URL para determinar a forma da URL com base em um protocolo especificado (por exemplo, http:) ou no posicionamento de uma barra (/) na cadeia de caracteres. Dependendo do membro específico, você pode usar os seguintes formulários de URL:

  • Uma URL absoluta Especifica o caminho completo e começa com um protocolo. Por exemplo, http://domain_or_server/[ sites/] Web_Site/ Lists/ List_Title/ AllItems.aspx.

  • Uma URL relativa de domínio baseia-se no domínio (que pode ser o nome de um servidor) de endereços e sempre começa com uma barra invertida. Especifica um caminho completo do site de nível superior ao nome do arquivo. Por exemplo, / [ sites/] Web_Site/ Lists/ List_Title/ AllItems.aspx.

  • Uma URL relativa de site baseia-se no endereço de um objeto de site ( SPWeb ). Ele not começar com uma barra invertida e especifica um caminho completo do endereço do site para o nome do arquivo. Por exemplo, Lists/List_Title/ AllItems.aspx.

  • Uma URL relativa de um arquivo ou pasta baseia-se na pasta que contém o arquivo. Ele não contiver any barras invertidas. Ele simplesmente especifica o nome do arquivo. Por exemplo, AllItems.aspx.

Observação

Não há conceito de "URL relativa ao conjunto de sites"; passar essa URL pode causar falha no código.

Boa prática para URLs de imagem

Quando cria um URL para um ficheiro de imagem localizado no diretório %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\1033\IMAGES, especifique um caminho que utilize o site raiz da coleção de sites, mas que não inclua um subsite dentro do caminho. Por exemplo, use /_layouts/images/MyImage.gif para um arquivo de imagem, não /MySubsite/_layouts/images/MyImage.gif. Isso ocorre porque subsite URLs serão resolvidos de maneiras diferentes dependendo de onde eles são usados. Se você usar sempre a URL do site relativos de raiz, você pode ignorar esses variações.

Tokens de URL no SharePoint

O SharePoint oferece suporte aos tokens listados nas tabelas a seguir para uso em Suplementos do SharePoint ou soluções de farm. Além disso, algumas tokens são utilizáveis somente nos aplicativos. Para obter mais informações sobre as mesmas, veja Cadeias de URL e tokens em Suplementos do SharePoint.

Os tokens nas tabelas desta seção podem ser usados em URLs em uma ampla variedade de situações no desenvolvimento do SharePoint, como em ações personalizadas e em links em páginas personalizadas. Em alguns contextos, alguns desses tokens não poderão ser usados. Três dos locais mais importantes onde apenas pode ser utilizada uma lista restrita de tokens são a página inicial de uma aplicação, uma ação personalizada na Web do anfitrião e a propriedade Src de uma peça de aplicação. Eles são chamados de check-out em colunas separadas, mas esses três não são uma lista exaustiva de casas onde os tokens podem ser usados.

A coluna de página inicial Especifica se o token pode ser usado no elemento StartPage de um manifesto de aplicativo. A coluna Ação personalizada Especifica se o token pode ser usado na URL de uma ação personalizada em um web host. A coluna Peça da Aplicação especifica se o token pode ser utilizado na propriedade Src da peça da aplicação.

Tokens que podem ser usados no início de uma URL

Token Resolvido como StartPage Ação personalizada Parte do aplicativo Comentários
~controlTemplates
 A URL da pasta virtual ControlTemplates para o site atual.
Não
 Não
 Não
~layouts
 A URL da pasta virtual Layouts para o site atual.
Não
 Não
 Não
~site
 A URL do site atual.
Não
 Não
 Sim
~sitecollection
 A URL do conjunto de sites pai do site atual.
Não
 Não
 Sim

Exceto quando indicado em contrário, nenhum destes tokens na tabela seguinte pode ser utilizado na parte do caminho do valor da propriedade Src da peça da aplicação. A coluna Peça da Aplicação refere-se à respetiva utilização na parte da cadeia de consulta do valor.

Tokens que podem ser usados dentro de uma URL

Token Resolvido como StartPage Ação personalizada Parte do aplicativo Comentários
{ControlTemplates}
 A URL da pasta virtual ControlTemplates para o site atual.
Não
 Não
 Não
{ItemId}
 A ID de um item em uma lista ou biblioteca (um inteiro).
Não
 Sim
 Não
{ItemUrl}
 A URL do item que está sendo tratado.
Não
 Sim
 Não
{Layouts}
 A URL da pasta virtual Layouts para o site atual.
Não
 Não
 Não
{ListId}
 A ID da lista atual (um GUID).
Não
 Sim
 Não
{RecurrenceId}
 O índice de recorrência de um evento recorrente.
Não
 Sim
 Não
 Não há suporte a esse token para uso em menus de contexto de itens de lista.
{Site}
 A URL do site atual.
Não
 Sim
 Sim
{SiteCollection}
 A URL do site pai do site atual.
Não
 Sim
 Sim
{SiteUrl}
 A URL do site atual.
Não
 Sim
 Não
{Source}
 A URL de solicitação HTTP.
Não
 Sim
 Não

Confira também