Recupere anexos e metadados de anexo

. NowAttachmentService A API permite que você execute operações CRUD em anexos e recupere metadados de anexo do seu ServiceNow instância.

Usando esta API, você pode:

• Carregue anexos para seu ServiceNow e as associou a um registro específico.
• Baixe um ou mais anexos.
• Excluir anexos.
• Valide um anexo comparando o hash calculado do anexo com o hash esperado.
• Baixar metadados do anexo. Esses metadados são gerados pelo seu ServiceNow instância quando um anexo é carregado.

Para obter informações adicionais sobre como trabalhar com anexos, consulte API de anexo .

Todos NowAttachmentService os métodos fornecem três implementações para retornar dados de resultados. Um que chama um manipulador de conclusão com os resultados de retorno, um que preforma um async/await e outro que retorna um Combine fornecedor (descontinuado). Por exemplo, cada um upload () o método carrega e associa um anexo especificado a um registro especificado. No entanto, o NowAttachmentService - upload(data: Data, configuration: NowAttachmentUploadConfiguration, progressUpdate: Escape ProgressUpdate, conclusão: Escape (<NowAttachmentMetadata, NowDataError>))o método chama um manipulador de conclusão com os resultados de retorno, o. NowAttachmentService - upload(data: Data, configuration: NowAttachmentUploadConfiguration, progressUpdate: Escapando ProgressUpdate) lançamentos assíncronos o método executa um async/await e o. NowAttachmentService - upload(data: Data, configuration: NowAttachmentUploadConfiguration, progressUpdate: Escapando ProgressUpdate)O método retorna um fornecedor combinado.

Antes de poder usar NowAttachmentService API, você deve importar NowData E inicialize um objeto NowAttachmentService.

// Import the NowData framework
import NowData

func makeAttachmentService(instanceUrl: URL, 
  completion: @escaping ((Result<NowAttachmentService, NowServiceErrors>) → Void))

Paginação de metadados de anexo

Você pode usar NowAttachmentService métodos para baixar metadados de anexo para um ou mais anexos. Ao baixar metadados de vários anexos, convém usar NowAttachmentService - attachmentMetadataPaginator(filtro: Filtro, limite: Int)método, que retorna um Paginador objeto que permite iterar facilmente a quantidade potencialmente grande de dados retornados. Normalmente, você usa resultados de retorno paginado para fornecer recursos de rolagem infinitos para dados apresentados em uma UITableView, uma UICollectionView (UIKit) ou uma lista (Swift UI) ou para simplificar a iteração de página dos resultados em geral.

Depois de obter um objeto Paginator, assine seu fornecedor para começar a receber dados.

paginator.publisher
  .subscribe(on: DispatchQueue.global())
  .receive(on: DispatchQueue.main)
  .sink { ... }
  .store(in: &subscriptions)

O objeto Paginator retornado fornece os seguintes métodos que permitem que você percorra os registros retornados:

• primeiro()
• last()
• next()
• anterior()
• redefinir()

Nota:

Alguns Paginador os métodos podem lançar uma exceção, como quando não há mais páginas para buscar.

Além disso, o objeto Paginator fornece propriedades que permitem obter informações sobre os dados paginados. Para obter detalhes adicionais sobre essas propriedades e os métodos disponíveis, consulte API Paginator - iOS.