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 |
| 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:
- Um gatilho do SharePoint, como quando um item é criado ou modificado.
- Uma ação de relé de alerta, como Obter alterações de item ou ficheiro como HTML de alerta.
- 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:
Tutoriais em vídeo
Guias passo a passo, exemplos e vídeos práticos estão disponíveis no canal 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 Share |
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. |