URLs e tokens no SharePoint

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.

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

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

Confira também

•   Criar soluções de farm no SharePoint

• Suporte avançado de Extranet

• Obter referências para sites, aplicativos Web e outros objetos principais

• Trabalhar com objetos de lista e conjuntos

• Tarefas de modelo de objeto de amostra