Retransmissão de Alerta (Pré-visualização)

O Alert Relay ajuda a substituir os alertas do SharePoint desativados por notificações mais ricas e modernas. Devolve alterações detalhadas ao nível do campo, bem como HTML de alertas prontos a usar, para que possa mostrar exatamente o que mudou em vez de notificações genéricas modificadas. Também pode usar informação de alterações e versões nas decisões e condições de fluxo.

Este conector está disponível nos seguintes produtos e regiões:

Serviço Classe Regions
Estúdio Copiloto Premium Todas as regiões Power Automate exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas Standard Todas as regiões do Logic Apps , exceto as seguintes:
     - Regiões Azure Government
     - Regiões Azure China
     - Departamento de Defesa dos EUA (DoD)
Power Apps Premium Todas as regiões Power Apps exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Power Automate Premium Todas as regiões Power Automate exceto as seguintes:
     - Governo dos EUA (CCG)
     - Governo dos EUA (GCC High)
     - China Cloud operado pela 21Vianet
     - Departamento de Defesa dos EUA (DoD)
Entrar em contato
Name Suporte independNET
URL https://independnet.com.au/alert-relay/support
Email support@alertbridge.com.au
Metadados do conector
Publicador independNET Software
Sítio Web https://independnet.com.au/alert-relay/
Política de privacidade https://independnet.com.au/alert-relay/privacy
Categorias Colaboração; Produtividade

Retransmissão de Alerta

Alert Relay para Power Platform e Microsoft 365 Copilot

O Alert Relay ajuda as organizações a substituir os clássicos SharePoint Alerts por soluções modernas do Power Automate e Copilot Studio. Compara itens, ficheiros e páginas do SharePoint com versões anteriores e devolve informação estruturada de alterações, histórico de versões e conteúdo de notificações prontas a usar, sem exigir que os criadores construam uma lógica complexa de comparação de versões do SharePoint.

Overview

Os gatilhos do SharePoint podem identificar que um item, ficheiro ou página mudou, mas não fornecem uma comparação completa dos valores anteriores e atuais.

Construir essa comparação exige frequentemente que os criadores recuperem versões, interpretem tokens de alteração, comparem campos e formatem resultados para notificações ou processamento a jusante.

O Alert Relay centraliza e funciona através de ações reutilizáveis para Power Automate e Copilot Studio.

Principais características

O Alert Relay centraliza que funciona através de ações reutilizáveis que podem:

  • identificar alterações detalhadas ao nível do campo
  • Retorne valores de campo anteriores e atuais
  • gerar HTML pronto a usar para emails de alerta do SharePoint
  • Recuperar histórico de versões do item, ficheiro e página
  • Compare a partir de um token de ativação, token de alteração, etiqueta de versão ou data
  • formatos suportam tipos complexos de campos SharePoint
  • return structured information para Power Automate e Microsoft 365 Copilot

O Alert Relay suporta listas SharePoint, bibliotecas de documentos e bibliotecas de Páginas do Site.

Introdução

Um fluxo típico de alertas do SharePoint inclui:

  1. Um gatilho do SharePoint, como quando um item é criado ou modificado.
  2. Uma ação de relé de alerta, como Obter alterações de item ou ficheiro como HTML de alerta.
  3. Um email ou outra ação de notificação que use o assunto devolvido e o corpo do HTML.

Para condições, formatação personalizada ou cenários de agentes do Microsoft Copilot Studio, use Obter Alterações Detalhadas de Item ou Ficheiro e trabalhe com a informação estruturada de alterações que devolve.

Para versões históricas do SharePoint, use Obter Histórico de Versões de Itens ou Ficheiros.

Documentation

Documentação, informações de referência de ações, exemplos e orientações para começar estão disponíveis em:

Documentação do Alert Relay

Tutoriais em vídeo

Guias passo a passo, exemplos e vídeos práticos estão disponíveis no canal Alert Relay no YouTube:

Alert Relay no YouTube

Licenciamento e Julgamento

O licenciamento do Alert Relay abrange todo o inquilino. Aplica-se um único período de teste ou subscrição em todo o tenant Microsoft Entra, e as suas unidades de utilização são partilhadas pelos fluxos do Alert Relay e pelos utilizadores nesse tenant.

O período experimental de 90 dias começa automaticamente quando qualquer ação do Alert Relay é executada pela primeira vez no tenant e inclui 300 unidades de utilização partilhadas ao longo do período de experiência. Para planos atuais e mais detalhes, consulte preços e licenciamento do Alert Relay.

Ações

Obtenha Alterações Detalhadas ao Item ou Ficheiro

Devolve alterações detalhadas ao nível do campo entre a versão atual de um item, ficheiro ou página do SharePoint e uma versão anterior.

A ação devolve informação estruturada incluindo valores anteriores e atuais, valores formatados e metadados de comparação. Use-o quando um agente de fluxo ou Microsoft Copilot Studio precisar de inspecionar, resumir ou agir sobre alterações individuais.

Obtenha alterações de itens ou ficheiros como HTML de alerta

Gera HTML pronto a usar que mostra o que mudou num item, ficheiro ou página do SharePoint.

A ação também devolve um assunto de email sugerido, título do item e link do item. Use-o para criar emails de alerta SharePoint mais ricos sem construir expressões complexas de HTML e comparação de versões em cada fluxo.

Obtenha Histórico de Versões de Itens ou Ficheiros

Devolve histórico de versões limitado e paginado para um item, ficheiro ou página do SharePoint.

A ação pode devolver campos SharePoint selecionados e suporta limites de versão, data e tokens de disparo SharePoint. Utilize-o para revisão histórica, auditoria, relatórios, aprovação e cenários de fluxo de trabalho conscientes da versão.

Informação sobre a versão do SharePoint para analisar

Decodifica a informação da janela de disparo e do token de mudança do SharePoint.

Use esta ação para recuperar o carimbo temporal do token, aplicar decisões baseadas em data ou versão, e filtrar gatilhos indesejados de versões menores ou rascunhos antes de chamar uma ação de alteração detalhada.

Usos Típicos

A Alert Relay pode ajudá-lo:

  • substituir os alertas clássicos do SharePoint pelos fluxos do Power Automate
  • Envie notificações formatadas a mostrar exatamente o que mudou
  • Compare valores anteriores e atuais para áreas empresariais importantes
  • acompanhar alterações aos metadados do documento e às páginas do SharePoint
  • recuperar histórico de versões de itens e ficheiros do SharePoint
  • Construir fluxos de trabalho de aprovação, revisão, governação e auditoria
  • fornecer informação estruturada sobre alterações ao SharePoint ao Microsoft 365 Copilot

Autenticação e Acesso

O Alert Relay utiliza autenticação delegada pelo Microsoft Entra ID.

O acesso ao SharePoint é realizado no contexto do utilizador iniciado sessão. O Alert Relay não concede permissões adicionais de SharePoint aos utilizadores, pelo que os utilizadores devem já ter acesso ao site, lista, biblioteca, item ou ficheiro relevante do SharePoint.

Requisitos e Âmbito Suportado

  • O Alert Relay suporta o SharePoint Online. O SharePoint Server on-premises não é suportado.
  • As ações são executadas quando chamadas pelo Power Automate ou outro cliente suportado. Para notificações de alteração, use um gatilho SharePoint apropriado para iniciar o fluxo.
  • As comparações usando tokens trigger do SharePoint baseiam-se na janela de trigger do SharePoint. A linha de base resultante pode diferir do limite de uma versão específica de um item.
  • Está disponível formatação detalhada para os tipos de campos SharePoint suportados. Consulte a documentação do Alert Relay para a referência atual do tipo de campo.

Support

Sítio Internet: https://independnet.com.au/alert-relay/

Apoio: https://independnet.com.au/alert-relay/support

E-mail: support@alertrelay.com.au

Política de privacidade: https://independnet.com.au/alert-relay/privacy

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Predefinição Parâmetros para criar conexão. Todas as regiões Não compartilhável

Padrão

Aplicável: Todas as regiões

Parâmetros para criar conexão.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limites de Limitação

Nome Chamadas Período de Renovação
Chamadas de API por conexão 100 60 segundos

Ações

Informação sobre a versão do SharePoint para analisar

Decodifica um SharePoint Compare a partir de um token. Quando também são fornecidos o Número de Versão e a Data de Modificação, determina-se se o item ou ficheiro é uma nova versão. Use esta ação não faturável em condições de fluxo antes de chamar ações faturáveis do Alert Relay.

Obtenha alterações de itens ou ficheiros como HTML de alerta

Devolve alterações prontas a usar no Alert Relay HTML para SharePoint, concebidas principalmente para emails de alerta, mas também utilizáveis em qualquer lugar onde HTML seja suportado. Os resultados podem incluir um importante teste do Alert Relay, subscrição ou aviso de utilização para o utilizador.

Obtenha Alterações Detalhadas ao Item ou Ficheiro

Recupera alterações detalhadas e formatadas ao nível de campo para um item ou ficheiro de SharePoint list, comparando a versão atual com uma versão anterior. Usa isto quando quiseres dados ricos de alteração, não apenas os indicadores de alteração verdadeiro/falso do SharePoint incorporados. Os resultados podem incluir um importante teste do Alert Relay, subscrição ou aviso de utilização para o utilizador.

Obtenha Histórico de Versões de Itens ou Ficheiros

Retorna até ao número de versões solicitadas para um item ou ficheiro da SharePoint list, a mais recente primeiro. Cada versão inclui detalhes de versão, valores de colunas, valores de texto formatados e indicadores que indicam quais as colunas alteradas em relação à versão disponível anterior. Selecione o site e a lista ou biblioteca enquanto configura esta ação para tornar as suas colunas disponíveis como conteúdo dinâmico. Os resultados podem incluir um importante teste do Alert Relay, subscrição ou aviso de utilização para o utilizador.

Informação sobre a versão do SharePoint para analisar

Decodifica um SharePoint Compare a partir de um token. Quando também são fornecidos o Número de Versão e a Data de Modificação, determina-se se o item ou ficheiro é uma nova versão. Use esta ação não faturável em condições de fluxo antes de chamar ações faturáveis do Alert Relay.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
Comparar de
compareFrom True string

TriggerWindowStartToken ou token de alteração bruto do SharePoint para descodificar. Etiquetas de versão e valores data/data-hora ISO não são suportados por esta ação.

Número da versão
versionNumber string

Número de versão do gatilho ou ação do SharePoint, como 0.1, 1.0 ou 1.5. Usado para identificar versões menores/rascunho.

Data de Modificação
modifiedDate date-time

Data modificada do gatilho ou ação do SharePoint. Usado para detetar se a versão visível do SharePoint mudou durante a janela de disparo.

Incluir versões secundárias
includeMinorVersions boolean

Se os números de versão menor/rascunho devem contar como novas versões. É definido para false por padrão.

Timezone
timezone string

Fuso horário opcional para valores de comparação local, como 'América/New_York', 'Europa/Londres' ou 'Austrália/Sydney' (ID do fuso horário IANA). Se for omitido, apenas o valor UTC é devolvido.

Devoluções

Nome Caminho Tipo Descrição
Sucesso
success boolean

Verdadeiro quando a informação da versão foi analisada com sucesso; falso quando a validação ou processamento falhou.

Message
message string

Mensagem voltada para o utilizador que descreve o resultado da operação. Os agentes e copilots devem mostrar esta mensagem ao utilizador quando contiver informações de teste, subscrição, utilização, aviso ou processamento de versões.

Token Data Hora UTC
tokenDateTimeUTC date-time

Data e hora do token Compare From, retornadas em UTC.

Token Data Hora Local
tokenDateTimeLocal date-time

Data e hora a partir do token Compare From, convertidas para o fuso horário selecionado.

Token Decodificado
decodedToken string

Token bruto de alteração do SharePoint após a decodificação. Se Compare From já fosse um token bruto, isto corresponde ao valor fornecido.

É o token Base64
isBase64Token boolean

É verdade quando o token recebido estava codificado base64.

Sequence
sequence integer

SharePoint altera o valor da sequência embutido no token.

Lista GUID
listGuid uuid

GUID da lista ou biblioteca embutido no token.

Versão do Token
tokenVersion integer

Número da versão do token.

Tipo de token
tokenType integer

Número do tipo de token do SharePoint.

Nova Versão Detetada
isNewVersionDetected boolean

É verdade quando os metadados de gatilho/ação fornecidos mostram que uma nova versão visível do SharePoint deve ser processada. False quando a versão devia ser ignorada. Nulo quando não há metadados suficientes para determinar.

É uma versão menor
isMinorVersion boolean

É verdade quando o número de versão fornecido é uma versão menor/rascunho. Nulo quando o Número de Versão não foi fornecido.

É a primeira versão menor
isFirstMinorVersion boolean

É verdade quando o Número de Versão fornecido é a primeira versão menor/rascunho, tipicamente 0.1. Nulo quando o Número de Versão não foi fornecido.

É a Primeira Versão Principal
isFirstMajorVersion boolean

É verdade quando o Número de Versão fornecido é a primeira versão principal/publicada, tipicamente 1.0. Nulo quando o Número de Versão não foi fornecido.

Data Modificada UTC
modifiedDateUtc date-time

Data modificada fornecida normalizada para UTC. Nulo quando a Data Modificada não foi fornecida.

Data Local Modificada
modifiedDateLocal date-time

Data Modificada fornecida convertida para o fuso horário selecionado. Nulo quando a Data Modificada ou o Fuso Horário não foram fornecidos.

Erro
error string

Erro detalha se o sucesso for falso.

Obtenha alterações de itens ou ficheiros como HTML de alerta

Devolve alterações prontas a usar no Alert Relay HTML para SharePoint, concebidas principalmente para emails de alerta, mas também utilizáveis em qualquer lugar onde HTML seja suportado. Os resultados podem incluir um importante teste do Alert Relay, subscrição ou aviso de utilização para o utilizador.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
URL do site
siteUrl True string

Selecione um site SharePoint ou introduza o URL do site.

Lista ou Biblioteca
listId True string

Selecione uma lista ou biblioteca, ou introduza o seu título ou GUID.

ID de item
itemId True integer

ID do item ou ficheiro SharePoint para analisar em busca de alterações.

Comparar de
triggerWindowStartToken string

Ponto de partida para a comparação. Use o TriggerWindowStartToken do gatilho do SharePoint quando disponível. Também pode inserir uma etiqueta de versão, token de alteração bruto ou data/hora base. Os valores apenas por data usam a meia-noite no fuso horário selecionado, ou UTC se não for selecionado nenhum fuso horário. Deixe em branco para comparar com a versão anterior.

Incluir versões secundárias
includeMinorVersions boolean

Se deve incluir versões menores ou de rascunho ao comparar as alterações. Por defeito, é falso, por isso apenas as versões principais são comparadas.

Incluir campos inalterados
includeUnchangedFields boolean

Se os campos inalterados devem ser incluídos no HTML gerado. O valor padrão é verdadeiro.

Formato de data
dateFormat string

Formato usado para campos DateTime (por exemplo, 'yyyy-MM-dd', 'dd/MM/yyyy'). Por defeito, é 'yyy-MM-dd'.

Formato de hora
timeFormat string

Formato usado para a parte temporal dos campos DateTime (por exemplo, HH:mm:ss, HH:mm, hh:mm tt). Por defeito é HH:mm:ss.

Timezone
timezone string

Fuso horário usado na formatação de datas e horas (por exemplo, América/New_York, Europa/Londres, Austrália/Sydney). Por defeito é UTC.

Devoluções

Nome Caminho Tipo Descrição
Sucesso
success boolean

Verdadeiro quando a ação foi concluída com sucesso; falso quando a validação ou processamento falhou.

Message
message string

Mensagem voltada para o utilizador que descreve o resultado da operação. Os agentes e copilots devem mostrar esta mensagem ao utilizador quando contiver informações de teste, subscrição, utilização, aviso ou processamento de versões.

Mostrar Aviso ao Utilizador
shouldDisplayUserNotice boolean

Indica se o Alert Relay devolveu um aviso importante de teste, subscrição ou utilização para o utilizador.

Código de Aviso do Utilizador
userNoticeCode string

Razão estável e legível por máquina para a perceção do utilizador.

Gravidade do Aviso do Utilizador
userNoticeSeverity string

Gravidade da apresentação para o aviso do utilizador: informação, aviso ou crítica.

Aviso ao Utilizador
userNotice string

Informação importante sobre o teste, subscrição ou utilização do Alert Relay.

Aviso do Utilizador Chamada para a Ação
userNoticeCallToAction string

O que o utilizador pode fazer a seguir, incluindo o site do Alert Relay e o email de suporte.

Corpo HTML
htmlBody string

Corpo HTML para a mensagem de alerta, pronto a ser usado em email ou em qualquer lugar onde HTML seja suportado.

Sujeito de Alerta Gerado
subject string

Linha de assunto sugerida para o alerta

Nome do Item ou Ficheiro
itemTitle string

Título ou nome de ficheiro do item ou ficheiro alterado.

URL do item ou ficheiro
itemUrl string

Link direto para o item ou ficheiro SharePoint alterado.

É um novo item
isNewItem boolean

Determina se o alerta gerado descreve o item ou ficheiro como adicionado ou alterado.

Erro
error string

Detalhes do erro se o sucesso for falso

Obtenha Alterações Detalhadas ao Item ou Ficheiro

Recupera alterações detalhadas e formatadas ao nível de campo para um item ou ficheiro de SharePoint list, comparando a versão atual com uma versão anterior. Usa isto quando quiseres dados ricos de alteração, não apenas os indicadores de alteração verdadeiro/falso do SharePoint incorporados. Os resultados podem incluir um importante teste do Alert Relay, subscrição ou aviso de utilização para o utilizador.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
URL do site
siteUrl True string

Selecione um site SharePoint ou introduza o URL do site.

Lista ou Biblioteca
listId True string

Selecione uma lista ou biblioteca, ou introduza o seu título ou GUID.

ID de item
itemId True integer

ID do item ou ficheiro SharePoint para analisar em busca de alterações.

Comparar de
triggerWindowStartToken string

Ponto de partida para a comparação. Use o TriggerWindowStartToken do gatilho do SharePoint quando disponível. Também pode inserir uma etiqueta de versão, token de alteração bruto ou data/hora base. Os valores apenas por data usam a meia-noite no fuso horário selecionado, ou UTC se não for selecionado nenhum fuso horário. Deixe em branco para comparar com a versão anterior.

Incluir versões secundárias
includeMinorVersions boolean

Se deve incluir versões menores ou de rascunho ao comparar as alterações. Por defeito, é falso, por isso apenas as versões principais são comparadas.

Incluir campos inalterados
includeUnchangedFields boolean

Se os campos inalterados deveriam ser incluídos na resposta. O valor padrão é verdadeiro.

Formato de data
dateFormat string

Formato usado para campos DateTime (por exemplo, 'yyyy-MM-dd', 'dd/MM/yyyy', 'MM/dd/yyyy'). Por defeito, é 'yyy-MM-dd'.

Formato de hora
timeFormat string

Formato usado para a parte temporal dos campos DateTime (por exemplo, HH:mm:ss, HH:mm, hh:mm tt). Por defeito é HH:mm:ss.

Timezone
timezone string

Fuso horário usado na formatação de datas e horas (por exemplo, América/New_York, Europa/Londres, Austrália/Sydney). Por defeito é UTC.

Devoluções

Nome Caminho Tipo Descrição
Sucesso
success boolean

Verdadeiro quando a ação foi concluída com sucesso; falso quando a validação ou processamento falhou.

Message
message string

Mensagem voltada para o utilizador que descreve o resultado da operação. Os agentes e copilots devem mostrar esta mensagem ao utilizador quando contiver informações de teste, subscrição, utilização, aviso ou processamento de versões.

Mostrar Aviso ao Utilizador
shouldDisplayUserNotice boolean

Indica se o Alert Relay devolveu um aviso importante de teste, subscrição ou utilização para o utilizador.

Código de Aviso do Utilizador
userNoticeCode string

Razão estável e legível por máquina para a perceção do utilizador.

Gravidade do Aviso do Utilizador
userNoticeSeverity string

Gravidade da apresentação para o aviso do utilizador: informação, aviso ou crítica.

Aviso ao Utilizador
userNotice string

Informação importante sobre o teste, subscrição ou utilização do Alert Relay.

Aviso do Utilizador Chamada para a Ação
userNoticeCallToAction string

O que o utilizador pode fazer a seguir, incluindo o site do Alert Relay e o email de suporte.

Áreas Mudadas
changedFields array of object

Lista de campos SharePoint comparados, incluindo o nome de cada campo, valor anterior, valor atual e se mudou.

O valor da coluna mudou
changedFields.hasChanged boolean

É verdade se o valor deste campo mudou entre a versão anterior e a atual

Valor da Coluna Anterior (Texto)
changedFields.previousAsString string

Valor anterior formatado como uma cadeia legível por humanos

Nome Interno do Campo
changedFields.internalName string

Nome interno do campo SharePoint

Nome do campo
changedFields.displayName string

Nome de exibição amigável para o campo

Valor da Coluna Anterior (Detalhado)
changedFields.previous

Valor bruto anterior. Esta propriedade é dinâmica e pode ser uma cadeia, número, booleana, objeto, array ou nula, dependendo do tipo de campo do SharePoint.

Valor Atual da Coluna (Texto)
changedFields.currentAsString string

Valor corrente formatado como uma cadeia legível por humanos

Valor Atual da Coluna (Detalhado)
changedFields.current

Valor atual bruto. Esta propriedade é dinâmica e pode ser uma cadeia, número, booleana, objeto, array ou nula, dependendo do tipo de campo do SharePoint.

Tem referência de comparação
hasComparisonBaseline boolean

É verdade se uma versão de referência distinta fosse resolvida para comparação com a versão atual.

É a Primeira Versão Base
isBaselineFirstVersion boolean

É verdade se a versão base resolvida for a primeira versão alguma vez registada para o item ou ficheiro.

É um novo item
isNewItem boolean

É verdade quando o item ou ficheiro deve ser tratado como novo na janela de comparação resolvida em vez de como uma atualização.

Rótulo de Versão Atual
currentVersionLabel string

Rótulo da versão atual (por exemplo, '2.0', '5.0')

Rótulo da Versão Anterior
previousVersionLabel string

Etiqueta de versão usada para comparação (por exemplo, '1.0', '4.0')

Nome do Item ou Ficheiro
itemTitle string

Título ou nome de ficheiro do item ou ficheiro alterado.

URL do item ou ficheiro
itemUrl string

Link direto para o item ou ficheiro SharePoint alterado.

Data de Modificação
modifiedDate date-time

Data e hora da última modificação.

Modificado por
modifiedBy string

Nome de exibição do utilizador que modificou o artigo pela última vez

Erro
error string

Detalhes do erro se o sucesso for falso

Obtenha Histórico de Versões de Itens ou Ficheiros

Retorna até ao número de versões solicitadas para um item ou ficheiro da SharePoint list, a mais recente primeiro. Cada versão inclui detalhes de versão, valores de colunas, valores de texto formatados e indicadores que indicam quais as colunas alteradas em relação à versão disponível anterior. Selecione o site e a lista ou biblioteca enquanto configura esta ação para tornar as suas colunas disponíveis como conteúdo dinâmico. Os resultados podem incluir um importante teste do Alert Relay, subscrição ou aviso de utilização para o utilizador.

Parâmetros

Nome Chave Obrigatório Tipo Descrição
URL do site
siteUrl True string

Selecione um site SharePoint ou introduza o URL do site.

Lista ou Biblioteca
listId True string

Selecione a lista ou biblioteca cujas colunas de versão devem estar disponíveis como conteúdo dinâmico no fluxo.

ID de item
itemId True integer

ID de item da SharePoint list. Isto pode ser fornecido dinamicamente em tempo de execução, por exemplo, a partir de um gatilho do SharePoint ou de uma ação de fluxo anterior.

Unidades de Utilização Máxima
maximumUsageUnits True integer

Limite obrigatório selecionado pelo chamador para as unidades de utilização que esta chamada pode consumir. O valor padrão é 1. Isto é uma guarda de faturação, não um limite de contagem de versões; uma unidade de utilização pode devolver múltiplas versões completas. Use o Maximum Versions para limitar o número de linhas de versões.

Versões Máximas
maximumVersions integer

Número máximo total de linhas de versões completas a devolver em todas as páginas. Deixe em branco para continuar até terminar a faixa selecionada, histórico disponível ou orçamento por unidades de utilização. Cada resposta contém no máximo 100 versões.

Campos a Regressar
fieldsToReturn array of string

Colunas do SharePoint para incluir em cada versão. Adiciona uma coluna por item. Deixe os campos para Devolver vazios para devolver todas as colunas suportadas. Selecionar menos colunas pode reduzir o tamanho da resposta e o trabalho em unidades de uso.

Comparar de
fromVersion string

Ponto de partida para a gama de histórico de versões. Use o TriggerWindowStartToken do gatilho do SharePoint quando disponível. Também pode inserir uma etiqueta de versão, token de alteração bruto ou data/hora base. Os valores apenas por data usam a meia-noite no fuso horário selecionado, ou UTC se não for selecionado nenhum fuso horário. Não deixe em branco para nenhum limite antigo.

Comparar com
toVersion string

Ponto final para o intervalo de histórico de versões. Use o TriggerWindowEndToken do gatilho do SharePoint quando disponível. Também pode inserir uma etiqueta de versão, token de alteração bruto ou data/hora. Os valores apenas por data usam a meia-noite no fuso horário selecionado, ou UTC se não for selecionado nenhum fuso horário. Deixe em branco para não haver limites mais recentes.

Ficha de Paginação
continuationToken string

Token usado para recuperar a página seguinte do histórico de versões, caso um tenha sido devolvido por uma chamada anterior.

Incluir versões secundárias
includeMinorVersions boolean

Se deve incluir versões menores ou rascunhos ao recuperar o histórico de versões. Por defeito é falso, por isso apenas as versões principais são devolvidas.

Formato de data
dateFormat string

Formato usado para campos DateTime (por exemplo, 'yyyy-MM-dd', 'dd/MM/yyyy', 'MM/dd/yyyy'). Por defeito, é 'yyy-MM-dd'.

Formato de hora
timeFormat string

Formato usado para a parte temporal dos campos DateTime (por exemplo, HH:mm:ss, HH:mm, hh:mm tt). Por defeito é HH:mm:ss.

Timezone
timezone string

Fuso horário usado na formatação de datas e horas (por exemplo, América/New_York, Europa/Londres, Austrália/Sydney). Por defeito é UTC.

Devoluções

As saídas desta operação são dinâmicas.