--- sourceDocument: Referência de API do Xanadu sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference Release : - xanadu ft:locale : - pt-BR ft:publication_title : - Referência de API do Xanadu ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # Classe NowAttachmentService - iOS # Classe NowAttachmentService - iOS {#ariaid-title1} * Versão de lançamento: Xanadu * * Atualizado 1 de ago. de 2024 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 32 min. de leitura A classe NowAttachmentService fornece funções que permitem carregar e consultar anexos associados a registros em uma tabela em uma instância ServiceNow. Você pode carregar ou recuperar um único arquivo com cada solicitação. O NowAttachmentService respeita todas as limitações do sistema em arquivos carregados, como tamanho máximo de arquivo e tipos de anexo permitidos. Você pode controlar essas configurações usando as propriedades de instância com.glide.attachment.max_size, 1024 MB por padrão e glide.attachment.extensions. Nota: O NowAttachmentService aceita todos os valores de tipo de conteúdo (/). Especifique o tipo de conteúdo do arquivo ao carregar um anexo. O tipo de conteúdo é armazenado com os metadados do arquivo, permitindo que outras ferramentas identifiquem e analisem corretamente o arquivo. {#NowAttachmentServiceiOSAPI__table_vx2_klw_5pb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | configuração | [NowServiceConfiguration](https://servicenow-prod.fluidtopics.net/flpam5S9jLear5y_v4eXdA#NowServiceConfigurationiOSStruct "A estrutura NowServiceConfiguration define informações de configuração para um serviço da feição.") | Definições de configuração fornecidas quando o serviço foi inicializado. | [Tabela 1. Propriedades] {#NowAttachmentServiceiOSAPI__table_vx2_klw_5pb} ## NowAttachmentService - anexo (para sysId: cadeia de caracteres, validAttachment: booliano) lançamentos assíncronos {#ariaid-title2} Recupera o anexo com o sys_id especificado e valida o anexo comparando o hash calculado do anexo com a soma de verificação SHA256 esperada. Nota: A validação de um anexo pode causar um impacto no desempenho. Você pode ignorar a etapa de validação definindo o parâmetro validateAttachment como `falso`. Você pode validar o anexo em um estágio posterior, se necessário, chamando a função Attachment.validate(). {#NAttServiOS-attachment-async_S_B_O__table_dqr_hmx_spb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | para sysId | Cadeia de caracteres | Sys_id do anexo a ser recuperado. | | validarAnexo | Booliano | Sinalizador que indica se o anexo deve ser validado. Valores válidos: * verdadeiro: validar o anexo. * falso: não valida o anexo. Padrão: verdadeiro | [Tabela 2. Parâmetros] {#NAttServiOS-attachment-async_S_B_O__table_dqr_hmx_spb} {#NAttServiOS-attachment-async_S_B_O__table_eqr_hmx_spb__entry__2} | Tipo | Descrição | |-|-| | NowAttachment | Retornado quando o método é bem-sucedido. Anexo especificado. | | NowDataError | Lançado quando o método falha. * `accessToken(AccessTokenProviderError)` * AccessTokenProviderError: o código ou a mensagem de erro do provedor de token de acesso. * accessTokenRetrievalFailed * userSessionError(_ erro: Erro) Lançado quando há um erro no token de acesso. * `attachmentValidation` Lançado quando um anexo falha na validação. * `BadResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode: Código de status recebido da instância. Lançado quando uma solicitação retorna uma resposta inesperada * `canDecodeModel(DecodingError)` * DecodingError: erro de decodificação detectado. Lançado quando um modelo Codable não pode ser decodificado do JSON. * `canDecodeProperty(tipo: qualquer, de: cadeia de caracteres)` * type: tipo encapsulado para decodificar a partir de uma cadeia de caracteres. * from: cadeia de caracteres a ser decodificada para o tipo especificado. Lançado quando um valor encapsulado em cadeia de caracteres não pode ser decodificado do JSON. * `can'tEncodeModel(EncodingError)` * EncodingError: erro de codificação detectado. Lançado quando um modelo Codable não pode ser codificado para JSON. * `canParseResponse` Lançado quando uma resposta da instância não pode ser analisada no formato esperado. * `URL inválido` Lançado quando um URL não pode ser formado. Por exemplo, se a cadeia de caracteres contiver caracteres que são ilegais em um URL ou for uma cadeia de caracteres vazia. * `ausenteAttachmentMetadata` Lançado quando o cabeçalho de metadados do anexo está ausente. * `ausenteConfiguraçãoDeServiço` Lançado quando uma configuração de serviço esperada está ausente. * `ausenteSysID` Lançado quando um parâmetro sys_id esperado está ausente. * `network(NetworkServiceError)` * genericError(cadeia de caracteres) * operaçãoCancelada * serviçoDesabilitado * serverError(Erro) * systemError (Erro) Lançado quando um serviço de rede encontrou um erro. {#NAttServiOS-attachment-async_S_B_O__NowDataErroriOS-ul-enum} | [Tabela 3. Retorna] {#NAttServiOS-attachment-async_S_B_O__table_eqr_hmx_spb} Os exemplos de código a seguir mostram como chamar este método. func downloadAttachment(sysId: String) async throws -> NowAttachment { do { let nowAttachment = try await attachmentService.attachment(for: sysId, validateAttachment: false) return nowAttachment } catch { // Handle NowDataError throw error } } ## NowAttachmentService - attachment(para sysId: cadeia de caracteres, validAttachment: booliano, conclusão: @escaping (resultado\ )) {#ariaid-title3} Recupera o anexo com o sys_id especificado e valida o anexo comparando o hash calculado do anexo com a soma de verificação SHA256 esperada. Depois de concluído, ele executa o manipulador de conclusão aprovado. Nota: A validação de um anexo pode causar um impacto no desempenho. Você pode ignorar a etapa de validação definindo o parâmetro validateAttachment como `falso`. Você pode validar o anexo em um estágio posterior, se necessário, chamando a função Attachment.validate(). {#NAttServiOS-attachment_S_B_O__table_dqr_hmx_spb__entry__3}{#NAttServiOS-attachment_S_B_O__mobilesdkiOS-completion_data_dataerror-row} | Nome | Tipo | Descrição | |-|-|-| | para sysId | Cadeia de caracteres | Sys_id do anexo a ser recuperado. | | validarAnexo | Booliano | Sinalizador que indica se o anexo deve ser validado. Valores válidos: * verdadeiro: validar o anexo. * falso: não valida o anexo. {#NAttServiOS-attachment_S_B_O__ul_ftq_1q5_4pb} Padrão: verdadeiro | | conclusão | @escaping (Resultado​\<[NowAttachment](https://servicenow-prod.fluidtopics.net/tpZkggMmhwrV6AnS9BPRSA#NowAttachmentiOSStructure "A estrutura NowAttachment fornece funções que permitem validar anexos comparando o hash calculado."), NowDataError\>) | Manipulador de conclusão a ser executado depois que o anexo for recuperado. Valores de retorno para o manipulador de conclusão: * Sucesso: [NowAttachment](https://servicenow-prod.fluidtopics.net/tpZkggMmhwrV6AnS9BPRSA#NowAttachmentiOSStructure "A estrutura NowAttachment fornece funções que permitem validar anexos comparando o hash calculado.") - Anexo solicitado * Falha: NowDataError * `accessToken(AccessTokenProviderError)` * AccessTokenProviderError: o código ou a mensagem de erro do provedor de token de acesso. * accessTokenRetrievalFailed * userSessionError(_ erro: Erro) Lançado quando há um erro no token de acesso. * `attachmentValidation` Lançado quando um anexo falha na validação. * `BadResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode: Código de status recebido da instância. Lançado quando uma solicitação retorna uma resposta inesperada * `canDecodeModel(DecodingError)` * DecodingError: erro de decodificação detectado. Lançado quando um modelo Codable não pode ser decodificado do JSON. * `canDecodeProperty(tipo: qualquer, de: cadeia de caracteres)` * type: tipo encapsulado para decodificar a partir de uma cadeia de caracteres. * from: cadeia de caracteres a ser decodificada para o tipo especificado. Lançado quando um valor encapsulado em cadeia de caracteres não pode ser decodificado do JSON. * `can'tEncodeModel(EncodingError)` * EncodingError: erro de codificação detectado. Lançado quando um modelo Codable não pode ser codificado para JSON. * `canParseResponse` Lançado quando uma resposta da instância não pode ser analisada no formato esperado. * `URL inválido` Lançado quando um URL não pode ser formado. Por exemplo, se a cadeia de caracteres contiver caracteres que são ilegais em um URL ou for uma cadeia de caracteres vazia. * `ausenteAttachmentMetadata` Lançado quando o cabeçalho de metadados do anexo está ausente. * `ausenteConfiguraçãoDeServiço` Lançado quando uma configuração de serviço esperada está ausente. * `ausenteSysID` Lançado quando um parâmetro sys_id esperado está ausente. * `network(NetworkServiceError)` * genericError(cadeia de caracteres) * operaçãoCancelada * serviçoDesabilitado * serverError(Erro) * systemError (Erro) Lançado quando um serviço de rede encontrou um erro. {#NAttServiOS-attachment_S_B_O__NowDataErroriOS-ul-enum} {#NAttServiOS-attachment_S_B_O__ul_uzx_thj_ppb} | [Tabela 4. Parâmetros] {#NAttServiOS-attachment_S_B_O__table_dqr_hmx_spb} {#NAttServiOS-attachment_S_B_O__table_eqr_hmx_spb__entry__2} | Tipo | Descrição | |-|-| | Nenhum(a) | | [Tabela 5. Retorna] {#NAttServiOS-attachment_S_B_O__table_eqr_hmx_spb} O exemplo de código a seguir mostra como chamar esta função. let sysId = UUID().uuidString // UUID for the attachment private func downloadAttachment(sysId: String) { attachmentService.attachment(for: sysId, validateAttachment: false) { (result) in switch result { case .success(let attachment): // Attachment retrieved successful, return attachment case .failure(let error): // Attachment retrieved failed, return NowDataError } } } ## NowAttachmentService - anexo (para sysId: cadeia de caracteres, validAttachment: booliano) {#ariaid-title4} Recupera o anexo com o sys_id especificado e valida o anexo comparando o hash calculado do anexo com o hash esperado. Nota: A validação de um anexo pode causar um impacto no desempenho. Você pode ignorar a etapa de validação definindo o parâmetro validateAttachment como `falso`. Se necessário, você pode validar o anexo posteriormente chamando a função Attachment.validate(). Nota: Este método foi descontinuado. Em vez disso, você deve usar a implementação assíncrona/aguardar do método. {#NAttServiOS-attachment_S_B__table_w4s_d3s_spb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | para sysId | Cadeia de caracteres | Sys_id do anexo a ser recuperado. | | validarAnexo | Booliano | Sinalizador que indica se o anexo deve ser validado. Valores válidos: * verdadeiro: validar o anexo. * falso: não valida o anexo. {#NAttServiOS-attachment_S_B__ul_ftq_1q5_4pb} Padrão: verdadeiro | [Tabela 6. Parâmetros] {#NAttServiOS-attachment_S_B__table_w4s_d3s_spb} {#NAttServiOS-attachment_S_B__table_x4s_d3s_spb__entry__2} | Tipo | Descrição | |-|-| | AnyPublisher​\<[NowAttachment](https://servicenow-prod.fluidtopics.net/tpZkggMmhwrV6AnS9BPRSA#NowAttachmentiOSStructure "A estrutura NowAttachment fornece funções que permitem validar anexos comparando o hash calculado."), NowDataError\> | Sucesso: [NowAttachment](https://servicenow-prod.fluidtopics.net/tpZkggMmhwrV6AnS9BPRSA#NowAttachmentiOSStructure "A estrutura NowAttachment fornece funções que permitem validar anexos comparando o hash calculado.") - Contém o anexo especificado. Falha: NowDataError * `accessToken(AccessTokenProviderError)` * AccessTokenProviderError: o código ou a mensagem de erro do provedor de token de acesso. * accessTokenRetrievalFailed * userSessionError(_ erro: Erro) Lançado quando há um erro no token de acesso. * `attachmentValidation` Lançado quando um anexo falha na validação. * `BadResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode: Código de status recebido da instância. Lançado quando uma solicitação retorna uma resposta inesperada * `canDecodeModel(DecodingError)` * DecodingError: erro de decodificação detectado. Lançado quando um modelo Codable não pode ser decodificado do JSON. * `canDecodeProperty(tipo: qualquer, de: cadeia de caracteres)` * type: tipo encapsulado para decodificar a partir de uma cadeia de caracteres. * from: cadeia de caracteres a ser decodificada para o tipo especificado. Lançado quando um valor encapsulado em cadeia de caracteres não pode ser decodificado do JSON. * `can'tEncodeModel(EncodingError)` * EncodingError: erro de codificação detectado. Lançado quando um modelo Codable não pode ser codificado para JSON. * `canParseResponse` Lançado quando uma resposta da instância não pode ser analisada no formato esperado. * `URL inválido` Lançado quando um URL não pode ser formado. Por exemplo, se a cadeia de caracteres contiver caracteres que são ilegais em um URL ou for uma cadeia de caracteres vazia. * `ausenteAttachmentMetadata` Lançado quando o cabeçalho de metadados do anexo está ausente. * `ausenteConfiguraçãoDeServiço` Lançado quando uma configuração de serviço esperada está ausente. * `ausenteSysID` Lançado quando um parâmetro sys_id esperado está ausente. * `network(NetworkServiceError)` * genericError(cadeia de caracteres) * operaçãoCancelada * serviçoDesabilitado * serverError(Erro) * systemError (Erro) Lançado quando um serviço de rede encontrou um erro. {#NAttServiOS-attachment_S_B__NowDataErroriOS-ul-enum} | [Tabela 7. Retorna] {#NAttServiOS-attachment_S_B__table_x4s_d3s_spb} O exemplo de código a seguir mostra como chamar essa função. let sysId = UUID().uuidString // UUID for the attachment private func downloadAttachment(sysId: String) { let publisher = self.attachmentService.attachment(for: sysId, validateAttachment: false) publisher .receive(on: DispatchQueue.main) .sink { [weak self] completion in if case let .failure(error) = completion { // Attachment retrieved failed, return NowDataError } } receiveValue: { [weak self] (attachment) in // Attachment retrieved successful, return attachment } .store(in: &subscriptions) } ## NowAttachmentService - attachmentMetadata (filtro: filtro, limite: int) lançamentos assíncronos {#ariaid-title5} Recupera os metadados de todos os anexos que atendem aos critérios especificados. {#NAttServiOS-attachMeta-async_S_I_O__table_tcn_cfs_spb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | filtros | [Filtro](https://servicenow-prod.fluidtopics.net/1RqttCAdBjxUrch4UDTvOw#FilteriOSStructure "A estrutura de filtro fornece a capacidade de configurar filtros que definem os dados a serem retornados nos resultados de retorno de uma consulta de endpoint REST.") | Opcional. Cadeia de caracteres de consulta a ser usada para filtrar os anexos cujos metadados serão retornados. Padrão: nulo - Retorna metadados para todos os anexos disponíveis. Leva em consideração o parâmetro limit. | | limite | Inteiro | Opcional. Número máximo de metadados de arquivo de anexo a serem retornados. Padrão: nil - Retorna todos os metadados que atendem às especificações de parâmetro filter. | [Tabela 8. Parâmetros] {#NAttServiOS-attachMeta-async_S_I_O__table_tcn_cfs_spb} {#NAttServiOS-attachMeta-async_S_I_O__table_ucn_cfs_spb__entry__2} | Tipo | Descrição | |-|-| | \[NowAttachmentMetadata\] | Retornado quando o método é bem-sucedido. Matriz que contém os metadados dos anexos correspondentes. | | NowDataError | Lançado quando o método falha. * `accessToken(AccessTokenProviderError)` * AccessTokenProviderError: o código ou a mensagem de erro do provedor de token de acesso. * accessTokenRetrievalFailed * userSessionError(_ erro: Erro) Lançado quando há um erro no token de acesso. * `attachmentValidation` Lançado quando um anexo falha na validação. * `BadResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode: Código de status recebido da instância. Lançado quando uma solicitação retorna uma resposta inesperada * `canDecodeModel(DecodingError)` * DecodingError: erro de decodificação detectado. Lançado quando um modelo Codable não pode ser decodificado do JSON. * `canDecodeProperty(tipo: qualquer, de: cadeia de caracteres)` * type: tipo encapsulado para decodificar a partir de uma cadeia de caracteres. * from: cadeia de caracteres a ser decodificada para o tipo especificado. Lançado quando um valor encapsulado em cadeia de caracteres não pode ser decodificado do JSON. * `can'tEncodeModel(EncodingError)` * EncodingError: erro de codificação detectado. Lançado quando um modelo Codable não pode ser codificado para JSON. * `canParseResponse` Lançado quando uma resposta da instância não pode ser analisada no formato esperado. * `URL inválido` Lançado quando um URL não pode ser formado. Por exemplo, se a cadeia de caracteres contiver caracteres que são ilegais em um URL ou for uma cadeia de caracteres vazia. * `ausenteAttachmentMetadata` Lançado quando o cabeçalho de metadados do anexo está ausente. * `ausenteConfiguraçãoDeServiço` Lançado quando uma configuração de serviço esperada está ausente. * `ausenteSysID` Lançado quando um parâmetro sys_id esperado está ausente. * `network(NetworkServiceError)` * genericError(cadeia de caracteres) * operaçãoCancelada * serviçoDesabilitado * serverError(Erro) * systemError (Erro) Lançado quando um serviço de rede encontrou um erro. {#NAttServiOS-attachMeta-async_S_I_O__NowDataErroriOS-ul-enum} | [Tabela 9. Retorna] {#NAttServiOS-attachMeta-async_S_I_O__table_ucn_cfs_spb} Os exemplos de código a seguir mostram como chamar este método. let filter = Filter(criteria: [], sortBy: [.desc("created")], queryCategory: nil) do { let metadata = try await attachmentService.attachmentMetadata(filter: filter, limit: 10) // Metadata retrieval successful } catch { // Metadata retrieval failed, NowDataError thrown } ## NowAttachmentService - attachmentMetadata(filtro: filtro, limite: int, conclusão: @escaping (Result\<\[NowAttachmentMetadata\], NowDataError\>)) {#ariaid-title6} Recupera os metadados de todos os anexos que atendem aos critérios especificados. {#NAttServiOS-attachMetadata_S_I_O__table_tcn_cfs_spb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | filtros | [Filtro](https://servicenow-prod.fluidtopics.net/1RqttCAdBjxUrch4UDTvOw#FilteriOSStructure "A estrutura de filtro fornece a capacidade de configurar filtros que definem os dados a serem retornados nos resultados de retorno de uma consulta de endpoint REST.") | Opcional. Cadeia de caracteres de consulta a ser usada para filtrar os anexos cujos metadados serão retornados. Padrão: nulo - Retorna metadados para todos os anexos disponíveis. Leva em consideração o parâmetro limit. | | limite | Inteiro | Opcional. Número máximo de metadados de arquivo de anexo a serem retornados. Padrão: nil - Retorna todos os metadados que atendem às especificações de parâmetro filter. | | conclusão | @escaping (Resultado​\<\[[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/phLzcUqCpZb1cYO_ycbXMA#NowAttachmentMetadataiOSStructure "A estrutura NowAttachmentMetadata fornece funções que permitem codificar e gerenciar metadados de anexo.")\], NowDataError\>) | Manipulador de conclusão a ser executado depois que os metadados forem recuperados. Valores de retorno para o manipulador de conclusão: * Sucesso: NowAttachmentMetadata - Objetos que contêm os metadados solicitados. * Erro: NowDataError * `accessToken(AccessTokenProviderError)` * AccessTokenProviderError: o código ou a mensagem de erro do provedor de token de acesso. * accessTokenRetrievalFailed * userSessionError(_ erro: Erro) Lançado quando há um erro no token de acesso. * `attachmentValidation` Lançado quando um anexo falha na validação. * `BadResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode: Código de status recebido da instância. Lançado quando uma solicitação retorna uma resposta inesperada * `canDecodeModel(DecodingError)` * DecodingError: erro de decodificação detectado. Lançado quando um modelo Codable não pode ser decodificado do JSON. * `canDecodeProperty(tipo: qualquer, de: cadeia de caracteres)` * type: tipo encapsulado para decodificar a partir de uma cadeia de caracteres. * from: cadeia de caracteres a ser decodificada para o tipo especificado. Lançado quando um valor encapsulado em cadeia de caracteres não pode ser decodificado do JSON. * `can'tEncodeModel(EncodingError)` * EncodingError: erro de codificação detectado. Lançado quando um modelo Codable não pode ser codificado para JSON. * `canParseResponse` Lançado quando uma resposta da instância não pode ser analisada no formato esperado. * `URL inválido` Lançado quando um URL não pode ser formado. Por exemplo, se a cadeia de caracteres contiver caracteres que são ilegais em um URL ou for uma cadeia de caracteres vazia. * `ausenteAttachmentMetadata` Lançado quando o cabeçalho de metadados do anexo está ausente. * `ausenteConfiguraçãoDeServiço` Lançado quando uma configuração de serviço esperada está ausente. * `ausenteSysID` Lançado quando um parâmetro sys_id esperado está ausente. * `network(NetworkServiceError)` * genericError(cadeia de caracteres) * operaçãoCancelada * serviçoDesabilitado * serverError(Erro) * systemError (Erro) Lançado quando um serviço de rede encontrou um erro. {#NAttServiOS-attachMetadata_S_I_O__NowDataErroriOS-ul-enum} {#NAttServiOS-attachMetadata_S_I_O__ul_uzx_thj_ppb} | [Tabela 10. Parâmetros] {#NAttServiOS-attachMetadata_S_I_O__table_tcn_cfs_spb} {#NAttServiOS-attachMetadata_S_I_O__table_ucn_cfs_spb__entry__2} | Tipo | Descrição | |-|-| | Nenhum(a) | | [Tabela 11. Retorna] {#NAttServiOS-attachMetadata_S_I_O__table_ucn_cfs_spb} O exemplo de código a seguir mostra como chamar essa função. let query = "active=true^short_descriptionLIKEbroken" let filter = Filter(query: query) attachmentService.attachmentMetadata(filter: filter, limit: limit) { (result) in DispatchQueue.main.async { [weak self] in switch result { case .success(let response): do { let data = try JSONEncoder().encode(response) // Retrieve metadata successfully, return data } catch { // Retrieve metadata failed, return error } case .failure(let error): // Retrieve metadata failed, return NowDataError } } } ## NowAttachmentService - attachmentMetadata (filtro: filtro, limite: int) {#ariaid-title7} Recupera os metadados de todos os anexos que atendem aos critérios especificados. Nota: Este método foi descontinuado. Em vez disso, você deve usar a implementação assíncrona/aguardar do método. {#NAttServiOS-attachMetadata_S_I__table_ahv_32s_spb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | filtros | [Filtro](https://servicenow-prod.fluidtopics.net/1RqttCAdBjxUrch4UDTvOw#FilteriOSStructure "A estrutura de filtro fornece a capacidade de configurar filtros que definem os dados a serem retornados nos resultados de retorno de uma consulta de endpoint REST.") | Opcional. Cadeia de caracteres de consulta a ser usada para filtrar os anexos cujos metadados serão retornados. Padrão: nulo - Retorna metadados para todos os anexos disponíveis. Leva em consideração o parâmetro limit. | | limite | Inteiro | Opcional. Número máximo de metadados de arquivo de anexo a serem retornados. Padrão: nil - Retorna todos os metadados que atendem às especificações de parâmetro filter. | [Tabela 12. Parâmetros] {#NAttServiOS-attachMetadata_S_I__table_ahv_32s_spb} {#NAttServiOS-attachMetadata_S_I__table_bhv_32s_spb__entry__2} | Tipo | Descrição | |-|-| | AnyPublisher​\<\[[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/phLzcUqCpZb1cYO_ycbXMA#NowAttachmentMetadataiOSStructure "A estrutura NowAttachmentMetadata fornece funções que permitem codificar e gerenciar metadados de anexo.")\], NowDataError\> | Sucesso: NowAttachmentMetadata - Objetos que contêm os metadados dos anexos correspondentes. Falha: NowDataError * `accessToken(AccessTokenProviderError)` * AccessTokenProviderError: o código ou a mensagem de erro do provedor de token de acesso. * accessTokenRetrievalFailed * userSessionError(_ erro: Erro) Lançado quando há um erro no token de acesso. * `attachmentValidation` Lançado quando um anexo falha na validação. * `BadResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode: Código de status recebido da instância. Lançado quando uma solicitação retorna uma resposta inesperada * `canDecodeModel(DecodingError)` * DecodingError: erro de decodificação detectado. Lançado quando um modelo Codable não pode ser decodificado do JSON. * `canDecodeProperty(tipo: qualquer, de: cadeia de caracteres)` * type: tipo encapsulado para decodificar a partir de uma cadeia de caracteres. * from: cadeia de caracteres a ser decodificada para o tipo especificado. Lançado quando um valor encapsulado em cadeia de caracteres não pode ser decodificado do JSON. * `can'tEncodeModel(EncodingError)` * EncodingError: erro de codificação detectado. Lançado quando um modelo Codable não pode ser codificado para JSON. * `canParseResponse` Lançado quando uma resposta da instância não pode ser analisada no formato esperado. * `URL inválido` Lançado quando um URL não pode ser formado. Por exemplo, se a cadeia de caracteres contiver caracteres que são ilegais em um URL ou for uma cadeia de caracteres vazia. * `ausenteAttachmentMetadata` Lançado quando o cabeçalho de metadados do anexo está ausente. * `ausenteConfiguraçãoDeServiço` Lançado quando uma configuração de serviço esperada está ausente. * `ausenteSysID` Lançado quando um parâmetro sys_id esperado está ausente. * `network(NetworkServiceError)` * genericError(cadeia de caracteres) * operaçãoCancelada * serviçoDesabilitado * serverError(Erro) * systemError (Erro) Lançado quando um serviço de rede encontrou um erro. {#NAttServiOS-attachMetadata_S_I__NowDataErroriOS-ul-enum} | [Tabela 13. Retorna] {#NAttServiOS-attachMetadata_S_I__table_bhv_32s_spb} O exemplo de código a seguir mostra como chamar esta função. let query = "active=true^short_descriptionLIKEbroken" let filter = Filter(query: query) let publisher = self.attachmentService.attachmentMetadata(filter: filter) publisher .receive(on: DispatchQueue.main) .encode(encoder: JSONEncoder()) .sink { [weak self] completion in if case let .failure(error) = completion { // Retrieve metadata failed, return NowDataError } receiveValue: { [weak self] (data) in // Retrieve metadata successfully, return data } .store(in: &subscriptions ## NowAttachmentService - attachmentMetadata (para sysId: cadeia de caracteres) lançamentos assíncronos {#ariaid-title8} Recupera os metadados do anexo associado ao sys_id especificado. {#NAttServiOS-attachMeta-async_S_O__table_ldt_3hs_spb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | para sysId | Cadeia de caracteres | Sys_id do anexo cujos metadados serão recuperados. | [Tabela 14. Parâmetros] {#NAttServiOS-attachMeta-async_S_O__table_ldt_3hs_spb} {#NAttServiOS-attachMeta-async_S_O__table_mdt_3hs_spb__entry__2} | Tipo | Descrição | |-|-| | NowAttachmentMetadata | Retornado quando o método é bem-sucedido. Metadados do anexo solicitado. | | NowDataError | Lançado quando o método falha. * `accessToken(AccessTokenProviderError)` * AccessTokenProviderError: o código ou a mensagem de erro do provedor de token de acesso. * accessTokenRetrievalFailed * userSessionError(_ erro: Erro) Lançado quando há um erro no token de acesso. * `attachmentValidation` Lançado quando um anexo falha na validação. * `BadResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode: Código de status recebido da instância. Lançado quando uma solicitação retorna uma resposta inesperada * `canDecodeModel(DecodingError)` * DecodingError: erro de decodificação detectado. Lançado quando um modelo Codable não pode ser decodificado do JSON. * `canDecodeProperty(tipo: qualquer, de: cadeia de caracteres)` * type: tipo encapsulado para decodificar a partir de uma cadeia de caracteres. * from: cadeia de caracteres a ser decodificada para o tipo especificado. Lançado quando um valor encapsulado em cadeia de caracteres não pode ser decodificado do JSON. * `can'tEncodeModel(EncodingError)` * EncodingError: erro de codificação detectado. Lançado quando um modelo Codable não pode ser codificado para JSON. * `canParseResponse` Lançado quando uma resposta da instância não pode ser analisada no formato esperado. * `URL inválido` Lançado quando um URL não pode ser formado. Por exemplo, se a cadeia de caracteres contiver caracteres que são ilegais em um URL ou for uma cadeia de caracteres vazia. * `ausenteAttachmentMetadata` Lançado quando o cabeçalho de metadados do anexo está ausente. * `ausenteConfiguraçãoDeServiço` Lançado quando uma configuração de serviço esperada está ausente. * `ausenteSysID` Lançado quando um parâmetro sys_id esperado está ausente. * `network(NetworkServiceError)` * genericError(cadeia de caracteres) * operaçãoCancelada * serviçoDesabilitado * serverError(Erro) * systemError (Erro) Lançado quando um serviço de rede encontrou um erro. {#NAttServiOS-attachMeta-async_S_O__NowDataErroriOS-ul-enum} | [Tabela 15. Retorna] {#NAttServiOS-attachMeta-async_S_O__table_mdt_3hs_spb} Os exemplos de código a seguir mostram como chamar este método. do { let metadata = try await attachmentService.attachmentMetadata(for: sysId) // Metadata retrieval successful } catch { // Metadata retrieval failed, NowDataError thrown } ## NowAttachmentService - attachmentMetadata(para sysId: cadeia de caracteres, conclusão: @escaping (resultado\ )) {#ariaid-title9} Recupera os metadados do anexo associado ao sys_id especificado e executa o manipulador de conclusão depois que os metadados são recuperados. {#NAttServiOS-attachMetadata_S_O__table_ldt_3hs_spb__entry__3}{#NAttServiOS-attachMetadata_S_O__mobilesdkiOS-completion_data_dataerror-row} | Nome | Tipo | Descrição | |-|-|-| | para sysId | Cadeia de caracteres | Sys_id do anexo cujos metadados serão recuperados. | | conclusão | @escaping (Resultado​\<[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/phLzcUqCpZb1cYO_ycbXMA#NowAttachmentMetadataiOSStructure "A estrutura NowAttachmentMetadata fornece funções que permitem codificar e gerenciar metadados de anexo."), NowDataError\>) | Manipulador de conclusão a ser executado depois que os metadados forem recuperados. Valores de retorno para o manipulador de conclusão: * Sucesso: [NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/phLzcUqCpZb1cYO_ycbXMA#NowAttachmentMetadataiOSStructure "A estrutura NowAttachmentMetadata fornece funções que permitem codificar e gerenciar metadados de anexo.") - Metadados solicitados * Falha: NowDataError * `accessToken(AccessTokenProviderError)` * AccessTokenProviderError: o código ou a mensagem de erro do provedor de token de acesso. * accessTokenRetrievalFailed * userSessionError(_ erro: Erro) Lançado quando há um erro no token de acesso. * `attachmentValidation` Lançado quando um anexo falha na validação. * `BadResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode: Código de status recebido da instância. Lançado quando uma solicitação retorna uma resposta inesperada * `canDecodeModel(DecodingError)` * DecodingError: erro de decodificação detectado. Lançado quando um modelo Codable não pode ser decodificado do JSON. * `canDecodeProperty(tipo: qualquer, de: cadeia de caracteres)` * type: tipo encapsulado para decodificar a partir de uma cadeia de caracteres. * from: cadeia de caracteres a ser decodificada para o tipo especificado. Lançado quando um valor encapsulado em cadeia de caracteres não pode ser decodificado do JSON. * `can'tEncodeModel(EncodingError)` * EncodingError: erro de codificação detectado. Lançado quando um modelo Codable não pode ser codificado para JSON. * `canParseResponse` Lançado quando uma resposta da instância não pode ser analisada no formato esperado. * `URL inválido` Lançado quando um URL não pode ser formado. Por exemplo, se a cadeia de caracteres contiver caracteres que são ilegais em um URL ou for uma cadeia de caracteres vazia. * `ausenteAttachmentMetadata` Lançado quando o cabeçalho de metadados do anexo está ausente. * `ausenteConfiguraçãoDeServiço` Lançado quando uma configuração de serviço esperada está ausente. * `ausenteSysID` Lançado quando um parâmetro sys_id esperado está ausente. * `network(NetworkServiceError)` * genericError(cadeia de caracteres) * operaçãoCancelada * serviçoDesabilitado * serverError(Erro) * systemError (Erro) Lançado quando um serviço de rede encontrou um erro. {#NAttServiOS-attachMetadata_S_O__NowDataErroriOS-ul-enum} {#NAttServiOS-attachMetadata_S_O__ul_uzx_thj_ppb} | [Tabela 16. Parâmetros] {#NAttServiOS-attachMetadata_S_O__table_ldt_3hs_spb} {#NAttServiOS-attachMetadata_S_O__table_mdt_3hs_spb__entry__2} | Tipo | Descrição | |-|-| | Nenhum(a) | | [Tabela 17. Retorna] {#NAttServiOS-attachMetadata_S_O__table_mdt_3hs_spb} O exemplo de código a seguir mostra como chamar esta função. let sysId = UUID().uuidString // UUID for the attachment attachmentService.attachmentMetadata(for: sysId) { (result) in DispatchQueue.main.async { [weak self] in switch result { case .success(let response): do { let data = try JSONEncoder().encode(response) // Retrieve metadata successfully, return data } catch { // Retrieve metadata failed, return error } case .failure(let error): // Retrieve metadata failed, return NowDataError } } } ## NowAttachmentService - attachmentMetadata (para sysId: cadeia de caracteres) {#ariaid-title10} Recupera os metadados do anexo associado ao sys_id especificado. Nota: Este método foi descontinuado. Em vez disso, você deve usar a implementação assíncrona/aguardar do método. {#NAttServiOS-attachMetadata_S__table_shc_ngs_spb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | para sysId | Cadeia de caracteres | Sys_id do anexo cujos metadados serão recuperados. | [Tabela 18. Parâmetros] {#NAttServiOS-attachMetadata_S__table_shc_ngs_spb} {#NAttServiOS-attachMetadata_S__table_thc_ngs_spb__entry__2} | Tipo | Descrição | |-|-| | AnyPublisher​\<\[[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/phLzcUqCpZb1cYO_ycbXMA#NowAttachmentMetadataiOSStructure "A estrutura NowAttachmentMetadata fornece funções que permitem codificar e gerenciar metadados de anexo.")\], NowDataError\> | Sucesso: NowAttachmentMetadata - Objeto que contém os metadados do anexo solicitado. Falha: NowDataError * `accessToken(AccessTokenProviderError)` * AccessTokenProviderError: o código ou a mensagem de erro do provedor de token de acesso. * accessTokenRetrievalFailed * userSessionError(_ erro: Erro) Lançado quando há um erro no token de acesso. * `attachmentValidation` Lançado quando um anexo falha na validação. * `BadResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode: Código de status recebido da instância. Lançado quando uma solicitação retorna uma resposta inesperada * `canDecodeModel(DecodingError)` * DecodingError: erro de decodificação detectado. Lançado quando um modelo Codable não pode ser decodificado do JSON. * `canDecodeProperty(tipo: qualquer, de: cadeia de caracteres)` * type: tipo encapsulado para decodificar a partir de uma cadeia de caracteres. * from: cadeia de caracteres a ser decodificada para o tipo especificado. Lançado quando um valor encapsulado em cadeia de caracteres não pode ser decodificado do JSON. * `can'tEncodeModel(EncodingError)` * EncodingError: erro de codificação detectado. Lançado quando um modelo Codable não pode ser codificado para JSON. * `canParseResponse` Lançado quando uma resposta da instância não pode ser analisada no formato esperado. * `URL inválido` Lançado quando um URL não pode ser formado. Por exemplo, se a cadeia de caracteres contiver caracteres que são ilegais em um URL ou for uma cadeia de caracteres vazia. * `ausenteAttachmentMetadata` Lançado quando o cabeçalho de metadados do anexo está ausente. * `ausenteConfiguraçãoDeServiço` Lançado quando uma configuração de serviço esperada está ausente. * `ausenteSysID` Lançado quando um parâmetro sys_id esperado está ausente. * `network(NetworkServiceError)` * genericError(cadeia de caracteres) * operaçãoCancelada * serviçoDesabilitado * serverError(Erro) * systemError (Erro) Lançado quando um serviço de rede encontrou um erro. {#NAttServiOS-attachMetadata_S__NowDataErroriOS-ul-enum} | [Tabela 19. Retorna] {#NAttServiOS-attachMetadata_S__table_thc_ngs_spb} O exemplo de código a seguir mostra como chamar esta função. let sysId = UUID().uuidString // UUID for the attachment let publisher = self.attachmentService.attachmentMetadata(for: sysId) publisher .receive(on: DispatchQueue.main) .encode(encoder: JSONEncoder()) .sink { [weak self] completion in if case let .failure(error) = completion { // Retrieve metadata failed, return NowDataError } } receiveValue: { [weak self] (data) in // Retrieve metadata successfully, return data } .store(in: &subscriptions) ## NowAttachmentService - attachmentMetadataPaginator (filtro: filtro, limite: int) {#ariaid-title11} Recupera os metadados de todos os anexos que atendem aos critérios especificados e retorna um objeto Paginator para iterar nas páginas dos metadados retornados. {#NAttServiOS-attachMetadataPag_S_I__table_tqh_dcs_spb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | filtros | [Filtro](https://servicenow-prod.fluidtopics.net/1RqttCAdBjxUrch4UDTvOw#FilteriOSStructure "A estrutura de filtro fornece a capacidade de configurar filtros que definem os dados a serem retornados nos resultados de retorno de uma consulta de endpoint REST.") | Opcional. Cadeia de caracteres de consulta a ser usada para filtrar os anexos cujos metadados serão retornados. Padrão: nulo - Retorna metadados para todos os anexos disponíveis. Leva em consideração o parâmetro limit. | | limite | Inteiro | Opcional. Número máximo de metadados de arquivo de anexo a serem retornados. Padrão: nil - Retorna todos os metadados que atendem às especificações de parâmetro filter. | [Tabela 20. Parâmetros] {#NAttServiOS-attachMetadataPag_S_I__table_tqh_dcs_spb} {#NAttServiOS-attachMetadataPag_S_I__table_uqh_dcs_spb__entry__2} | Tipo | Descrição | |-|-| | [Paginador](https://servicenow-prod.fluidtopics.net/vMzdYOjtpyL5Ku2LCoFwBw#PaginatorIOSAPI "A classe Paginator fornece métodos para iterar por meio de um conjunto de registros retornado por uma chamada para a API de ServiceNow tabela por meio do NowTableService. É o objeto retornado pelos métodos NowTableService paginator(). Não chame este método fora desse ambiente.")​\<\[[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/phLzcUqCpZb1cYO_ycbXMA#NowAttachmentMetadataiOSStructure "A estrutura NowAttachmentMetadata fornece funções que permitem codificar e gerenciar metadados de anexo.")\]\> | Sucesso: matriz de objetos NowAttachmentMetadata. Falha: objeto NowDataError. * `accessToken(AccessTokenProviderError)` * AccessTokenProviderError: o código ou a mensagem de erro do provedor de token de acesso. * accessTokenRetrievalFailed * userSessionError(_ erro: Erro) Lançado quando há um erro no token de acesso. * `attachmentValidation` Lançado quando um anexo falha na validação. * `BadResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode: Código de status recebido da instância. Lançado quando uma solicitação retorna uma resposta inesperada * `canDecodeModel(DecodingError)` * DecodingError: erro de decodificação detectado. Lançado quando um modelo Codable não pode ser decodificado do JSON. * `canDecodeProperty(tipo: qualquer, de: cadeia de caracteres)` * type: tipo encapsulado para decodificar a partir de uma cadeia de caracteres. * from: cadeia de caracteres a ser decodificada para o tipo especificado. Lançado quando um valor encapsulado em cadeia de caracteres não pode ser decodificado do JSON. * `can'tEncodeModel(EncodingError)` * EncodingError: erro de codificação detectado. Lançado quando um modelo Codable não pode ser codificado para JSON. * `canParseResponse` Lançado quando uma resposta da instância não pode ser analisada no formato esperado. * `URL inválido` Lançado quando um URL não pode ser formado. Por exemplo, se a cadeia de caracteres contiver caracteres que são ilegais em um URL ou for uma cadeia de caracteres vazia. * `ausenteAttachmentMetadata` Lançado quando o cabeçalho de metadados do anexo está ausente. * `ausenteConfiguraçãoDeServiço` Lançado quando uma configuração de serviço esperada está ausente. * `ausenteSysID` Lançado quando um parâmetro sys_id esperado está ausente. * `network(NetworkServiceError)` * genericError(cadeia de caracteres) * operaçãoCancelada * serviçoDesabilitado * serverError(Erro) * systemError (Erro) Lançado quando um serviço de rede encontrou um erro. {#NAttServiOS-attachMetadataPag_S_I__NowDataErroriOS-ul-enum} | [Tabela 21. Retorna] {#NAttServiOS-attachMetadataPag_S_I__table_uqh_dcs_spb} O exemplo de código a seguir mostra como chamar esta função. let paginator: Paginator = makePaginator(query: query, fetchLimit: 1) func makePaginator(query: String, fetchLimit: Int?) -> Paginator<[NowAttachmentMetadata]> { attachmentsService.attachmentMetadataPaginator(filter: Filter(query: query), limit: fetchLimit) } ## NowAttachmentService - delete(sysId: String) lançamentos assíncronos {#ariaid-title12} Exclui o anexo com o sys_id especificado. {#NAttServiOS-delete-async_S_O__table_e5b_zqx_spb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | sysId | Cadeia de caracteres | Sys_id do anexo a ser excluído. | [Tabela 22. Parâmetros] {#NAttServiOS-delete-async_S_O__table_e5b_zqx_spb} {#NAttServiOS-delete-async_S_O__table_f5b_zqx_spb__entry__2} | Tipo | Descrição | |-|-| | Nenhum(a) | Nada será retornado se o método tiver sido bem-sucedido. | | NowDataError | Lançado quando o método falha. * `accessToken(AccessTokenProviderError)` * AccessTokenProviderError: o código ou a mensagem de erro do provedor de token de acesso. * accessTokenRetrievalFailed * userSessionError(_ erro: Erro) Lançado quando há um erro no token de acesso. * `attachmentValidation` Lançado quando um anexo falha na validação. * `BadResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode: Código de status recebido da instância. Lançado quando uma solicitação retorna uma resposta inesperada * `canDecodeModel(DecodingError)` * DecodingError: erro de decodificação detectado. Lançado quando um modelo Codable não pode ser decodificado do JSON. * `canDecodeProperty(tipo: qualquer, de: cadeia de caracteres)` * type: tipo encapsulado para decodificar a partir de uma cadeia de caracteres. * from: cadeia de caracteres a ser decodificada para o tipo especificado. Lançado quando um valor encapsulado em cadeia de caracteres não pode ser decodificado do JSON. * `can'tEncodeModel(EncodingError)` * EncodingError: erro de codificação detectado. Lançado quando um modelo Codable não pode ser codificado para JSON. * `canParseResponse` Lançado quando uma resposta da instância não pode ser analisada no formato esperado. * `URL inválido` Lançado quando um URL não pode ser formado. Por exemplo, se a cadeia de caracteres contiver caracteres que são ilegais em um URL ou for uma cadeia de caracteres vazia. * `ausenteAttachmentMetadata` Lançado quando o cabeçalho de metadados do anexo está ausente. * `ausenteConfiguraçãoDeServiço` Lançado quando uma configuração de serviço esperada está ausente. * `ausenteSysID` Lançado quando um parâmetro sys_id esperado está ausente. * `network(NetworkServiceError)` * genericError(cadeia de caracteres) * operaçãoCancelada * serviçoDesabilitado * serverError(Erro) * systemError (Erro) Lançado quando um serviço de rede encontrou um erro. {#NAttServiOS-delete-async_S_O__NowDataErroriOS-ul-enum} | [Tabela 23. Retorna] {#NAttServiOS-delete-async_S_O__table_f5b_zqx_spb} Os exemplos de código a seguir mostram como chamar este método. do { try await attachmentService.delete(sysId: sysId) // Deletion successful } catch { // Deletion failed, NowDataError thrown } ## NowAttachmentService - delete(sysId: cadeia de caracteres, conclusão: @escaping (resultado\ )) {#ariaid-title13} Exclui o anexo com o sys_id especificado e executa o manipulador de conclusão aprovado depois que o anexo é excluído. {#NAttServiOS-delete_S_O__table_e5b_zqx_spb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | sysId | Cadeia de caracteres | Sys_id do anexo a ser excluído. | | conclusão | @escaping (resultado\ ) | Manipulador de conclusão a ser executado depois que o anexo for excluído. Valores de retorno para o manipulador de conclusão: * Sucesso: vazio * Erro: NowDataError * `accessToken(AccessTokenProviderError)` * AccessTokenProviderError: o código ou a mensagem de erro do provedor de token de acesso. * accessTokenRetrievalFailed * userSessionError(_ erro: Erro) Lançado quando há um erro no token de acesso. * `attachmentValidation` Lançado quando um anexo falha na validação. * `BadResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode: Código de status recebido da instância. Lançado quando uma solicitação retorna uma resposta inesperada * `canDecodeModel(DecodingError)` * DecodingError: erro de decodificação detectado. Lançado quando um modelo Codable não pode ser decodificado do JSON. * `canDecodeProperty(tipo: qualquer, de: cadeia de caracteres)` * type: tipo encapsulado para decodificar a partir de uma cadeia de caracteres. * from: cadeia de caracteres a ser decodificada para o tipo especificado. Lançado quando um valor encapsulado em cadeia de caracteres não pode ser decodificado do JSON. * `can'tEncodeModel(EncodingError)` * EncodingError: erro de codificação detectado. Lançado quando um modelo Codable não pode ser codificado para JSON. * `canParseResponse` Lançado quando uma resposta da instância não pode ser analisada no formato esperado. * `URL inválido` Lançado quando um URL não pode ser formado. Por exemplo, se a cadeia de caracteres contiver caracteres que são ilegais em um URL ou for uma cadeia de caracteres vazia. * `ausenteAttachmentMetadata` Lançado quando o cabeçalho de metadados do anexo está ausente. * `ausenteConfiguraçãoDeServiço` Lançado quando uma configuração de serviço esperada está ausente. * `ausenteSysID` Lançado quando um parâmetro sys_id esperado está ausente. * `network(NetworkServiceError)` * genericError(cadeia de caracteres) * operaçãoCancelada * serviçoDesabilitado * serverError(Erro) * systemError (Erro) Lançado quando um serviço de rede encontrou um erro. {#NAttServiOS-delete_S_O__NowDataErroriOS-ul-enum} | [Tabela 24. Parâmetros] {#NAttServiOS-delete_S_O__table_e5b_zqx_spb} {#NAttServiOS-delete_S_O__table_f5b_zqx_spb__entry__2} | Tipo | Descrição | |-|-| | Nenhum(a) | | [Tabela 25. Retorna] {#NAttServiOS-delete_S_O__table_f5b_zqx_spb} O exemplo de código a seguir mostra como chamar esta função. let sysId = UUID().uuidString // UUID for the attachment attachmentService.delete(sysId: sysId) { (result) in DispatchQueue.main.async { [weak self] in switch result { case .success: // Attachment with sysId is deleted case .failure(let error): // Failed to delete, with NowDataError } } } ## NowAttachmentService - delete(sysId: cadeia de caracteres) {#ariaid-title14} Exclui o anexo com o sys_id especificado. Nota: Este método foi descontinuado. Em vez disso, você deve usar a implementação assíncrona/aguardar do método. {#NAttServiOS-delete_S__table_svp_2qx_spb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | sysId | Cadeia de caracteres | Sys_id do anexo a ser excluído. | [Tabela 26. Parâmetros] {#NAttServiOS-delete_S__table_svp_2qx_spb} {#NAttServiOS-delete_S__table_tvp_2qx_spb__entry__2} | Tipo | Descrição | |-|-| | Qualquer publicador\ | Sucesso: nada foi retornado Falha: NowDataError * `accessToken(AccessTokenProviderError)` * AccessTokenProviderError: o código ou a mensagem de erro do provedor de token de acesso. * accessTokenRetrievalFailed * userSessionError(_ erro: Erro) Lançado quando há um erro no token de acesso. * `attachmentValidation` Lançado quando um anexo falha na validação. * `BadResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode: Código de status recebido da instância. Lançado quando uma solicitação retorna uma resposta inesperada * `canDecodeModel(DecodingError)` * DecodingError: erro de decodificação detectado. Lançado quando um modelo Codable não pode ser decodificado do JSON. * `canDecodeProperty(tipo: qualquer, de: cadeia de caracteres)` * type: tipo encapsulado para decodificar a partir de uma cadeia de caracteres. * from: cadeia de caracteres a ser decodificada para o tipo especificado. Lançado quando um valor encapsulado em cadeia de caracteres não pode ser decodificado do JSON. * `can'tEncodeModel(EncodingError)` * EncodingError: erro de codificação detectado. Lançado quando um modelo Codable não pode ser codificado para JSON. * `canParseResponse` Lançado quando uma resposta da instância não pode ser analisada no formato esperado. * `URL inválido` Lançado quando um URL não pode ser formado. Por exemplo, se a cadeia de caracteres contiver caracteres que são ilegais em um URL ou for uma cadeia de caracteres vazia. * `ausenteAttachmentMetadata` Lançado quando o cabeçalho de metadados do anexo está ausente. * `ausenteConfiguraçãoDeServiço` Lançado quando uma configuração de serviço esperada está ausente. * `ausenteSysID` Lançado quando um parâmetro sys_id esperado está ausente. * `network(NetworkServiceError)` * genericError(cadeia de caracteres) * operaçãoCancelada * serviçoDesabilitado * serverError(Erro) * systemError (Erro) Lançado quando um serviço de rede encontrou um erro. {#NAttServiOS-delete_S__NowDataErroriOS-ul-enum} | [Tabela 27. Retorna] {#NAttServiOS-delete_S__table_tvp_2qx_spb} O exemplo de código a seguir mostra como chamar esta função. let publisher = attachmentService.delete(sysId: sysId) publisher .receive(on: DispatchQueue.main) .sink { [weak self] completion in switch completion { case .finished: // Attachment with sysId is deleted case .failure(let error): // Failed to delete, with NowDataError } } receiveValue: { } .store(in: &subscriptions) ## NowAttachmentService - init(configuration: NowServiceConfiguration, coreServiceProvider: NowCoreServiceProviding) {#ariaid-title15} Inicializa uma nova instância NowAttachmentService. {#NAttServiOS-init_O_O__table_hfm_ry2_tpb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | configuração | [NowServiceConfiguration](https://servicenow-prod.fluidtopics.net/flpam5S9jLear5y_v4eXdA#NowServiceConfigurationiOSStruct "A estrutura NowServiceConfiguration define informações de configuração para um serviço da feição.") | Informações de configuração necessárias para inicializar corretamente o serviço. | | coreServiceProvider | NowCoreServiceProviding | Opcional. Objeto que implementa o protocolo NowCoreServiceProviding. Padrão: nulo | [Tabela 28. Parâmetros] {#NAttServiOS-init_O_O__table_hfm_ry2_tpb} O exemplo de código a seguir mostra como chamar esta função. guard let coreService = NowSDK.core() else { // Error with NowServiceError.sdkNotConfigured return } guard let instanceUrl = URL(string: "http://sample.service-now.com"), let serviceConfig = NowSDK.makeServiceConfiguration(for: instanceUrl) else { // Could not create service -- // NowServiceError.serviceConfigurationInvalid return } let attachmentService = NowAttachmentService(configuration: serviceConfig, coreServiceProvider: coreService) ## NowAttachmentService - upload (dados: dados, configuração: NowAttachmentUploadConfiguration, progressUpdate: @escaping ProgressUpdate) lançamentos assíncronos {#ariaid-title16} Carrega os dados do anexo e os anexa a um registro em uma tabela conforme especificado na configuração de carregamento. O retorno de chamada ProgressUpdate fornece informações de andamento de carregamento que você pode usar para fornecer feedback de IU. {#NAttServiOS-upload-async_O_O_O_O__table_n5z_mpx_spb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | dados | Dados | Anexo a ser carregado. | | configuração | [Configuração do NowAttachmentUpload](https://servicenow-prod.fluidtopics.net/VSWs2mMUqhRTaAwVPhdN1Q#NowAttachUploadConfigiOSStruct "A estrutura NowAttachmentUploadConfiguration permite que você defina as informações de configuração de um anexo que você está carregando para sua instância ServiceNow.") | Informações de configuração que definem os parâmetros de carregamento do anexo, como: * Tabela e registro aos quais o arquivo será anexado * Nome do arquivo de anexo * Tipo de anexo * Se o arquivo está criptografado | | progressoAtualizar | @escaping ProgressUpdate | Manipulador de conclusão a ser executado depois que o anexo for recuperado. Isso é chamado várias vezes até que o processo de carregamento seja concluído. Valores de retorno para o manipulador de conclusão: ProgressUpdate --- Retorna o andamento atual do upload. `ProgressUpdate = (_bytesWritten: Int64, _totalBytesWritten: Int64, _totalBytesExpectedToWrite: Int64) -> Void` | [Tabela 29. Parâmetros] {#NAttServiOS-upload-async_O_O_O_O__table_n5z_mpx_spb} {#NAttServiOS-upload-async_O_O_O_O__table_o5z_mpx_spb__entry__2} | Tipo | Descrição | |-|-| | NowAttachmentMetadata | Retornado quando o método é bem-sucedido. Objeto que contém os metadados carregados. | | NowDataError | Lançado quando o método falha. * `accessToken(AccessTokenProviderError)` * AccessTokenProviderError: o código ou a mensagem de erro do provedor de token de acesso. * accessTokenRetrievalFailed * userSessionError(_ erro: Erro) Lançado quando há um erro no token de acesso. * `attachmentValidation` Lançado quando um anexo falha na validação. * `BadResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode: Código de status recebido da instância. Lançado quando uma solicitação retorna uma resposta inesperada * `canDecodeModel(DecodingError)` * DecodingError: erro de decodificação detectado. Lançado quando um modelo Codable não pode ser decodificado do JSON. * `canDecodeProperty(tipo: qualquer, de: cadeia de caracteres)` * type: tipo encapsulado para decodificar a partir de uma cadeia de caracteres. * from: cadeia de caracteres a ser decodificada para o tipo especificado. Lançado quando um valor encapsulado em cadeia de caracteres não pode ser decodificado do JSON. * `can'tEncodeModel(EncodingError)` * EncodingError: erro de codificação detectado. Lançado quando um modelo Codable não pode ser codificado para JSON. * `canParseResponse` Lançado quando uma resposta da instância não pode ser analisada no formato esperado. * `URL inválido` Lançado quando um URL não pode ser formado. Por exemplo, se a cadeia de caracteres contiver caracteres que são ilegais em um URL ou for uma cadeia de caracteres vazia. * `ausenteAttachmentMetadata` Lançado quando o cabeçalho de metadados do anexo está ausente. * `ausenteConfiguraçãoDeServiço` Lançado quando uma configuração de serviço esperada está ausente. * `ausenteSysID` Lançado quando um parâmetro sys_id esperado está ausente. * `network(NetworkServiceError)` * genericError(cadeia de caracteres) * operaçãoCancelada * serviçoDesabilitado * serverError(Erro) * systemError (Erro) Lançado quando um serviço de rede encontrou um erro. {#NAttServiOS-upload-async_O_O_O_O__NowDataErroriOS-ul-enum} | [Tabela 30. Retorna] {#NAttServiOS-upload-async_O_O_O_O__table_o5z_mpx_spb} Os exemplos de código a seguir mostram como chamar este método. func uploadFile(for tableName: String, sysId: String, mimeType: String, encryptionContext: String?, data: Data, filename: String) async throws -> NowAttachmentMetadata { let mimeType = MediaUtilities.mimeType(forFileName: filename) let uploadConfig = NowAttachmentUploadConfiguration(tableName: tableName, recordSysId: sysId, fileName: filename, contentType: mimeType, encryptionContext: encryptionContext) do { let attachmentMetadata = try await attachmentService.upload(data: data, configuration: uploadConfig) { (_, _, _) in } return attachmentMetadata } catch { // Handle NowDataError throw error } } ## NowAttachmentService - upload (dados: dados, configuração: NowAttachmentUploadConfiguration, progressUpdate: @escaping ProgressUpdate, conclusão: @escaping (resultado\ )) {#ariaid-title17} Carrega os dados do anexo e os anexa a um registro em uma tabela conforme especificado na configuração de carregamento. O retorno de chamada ProgressUpdate fornece informações de andamento de carregamento que você pode usar para fornecer feedback de IU. {#NAttServiOS-upload_O_O_O_O__table_n5z_mpx_spb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | dados | Dados | Anexo a ser carregado. | | configuração | [Configuração do NowAttachmentUpload](https://servicenow-prod.fluidtopics.net/VSWs2mMUqhRTaAwVPhdN1Q#NowAttachUploadConfigiOSStruct "A estrutura NowAttachmentUploadConfiguration permite que você defina as informações de configuração de um anexo que você está carregando para sua instância ServiceNow.") | Informações de configuração que definem os parâmetros de carregamento do anexo, como: * Tabela e registro aos quais o arquivo será anexado * Nome do arquivo de anexo * Tipo de anexo * Se o arquivo está criptografado | | progressoAtualizar | @escaping ProgressUpdate | Manipulador de conclusão a ser executado depois que o anexo for recuperado. Isso é chamado várias vezes até que o processo de carregamento seja concluído. Valores de retorno para o manipulador de conclusão: ProgressUpdate --- Retorna o andamento atual do upload. `ProgressUpdate = (_bytesWritten: Int64, _totalBytesWritten: Int64, _totalBytesExpectedToWrite: Int64) -> Void` | | conclusão | @escaping (Resultado\<[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/phLzcUqCpZb1cYO_ycbXMA#NowAttachmentMetadataiOSStructure "A estrutura NowAttachmentMetadata fornece funções que permitem codificar e gerenciar metadados de anexo."), NowDataError\>) | Manipulador de conclusão a ser executado após o carregamento dos metadados. Valores de retorno para o manipulador de conclusão: * Sucesso: [NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/phLzcUqCpZb1cYO_ycbXMA#NowAttachmentMetadataiOSStructure "A estrutura NowAttachmentMetadata fornece funções que permitem codificar e gerenciar metadados de anexo.") - Objeto que contém os metadados do anexo carregado. * Erro: NowDataError * `accessToken(AccessTokenProviderError)` * AccessTokenProviderError: o código ou a mensagem de erro do provedor de token de acesso. * accessTokenRetrievalFailed * userSessionError(_ erro: Erro) Lançado quando há um erro no token de acesso. * `attachmentValidation` Lançado quando um anexo falha na validação. * `BadResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode: Código de status recebido da instância. Lançado quando uma solicitação retorna uma resposta inesperada * `canDecodeModel(DecodingError)` * DecodingError: erro de decodificação detectado. Lançado quando um modelo Codable não pode ser decodificado do JSON. * `canDecodeProperty(tipo: qualquer, de: cadeia de caracteres)` * type: tipo encapsulado para decodificar a partir de uma cadeia de caracteres. * from: cadeia de caracteres a ser decodificada para o tipo especificado. Lançado quando um valor encapsulado em cadeia de caracteres não pode ser decodificado do JSON. * `can'tEncodeModel(EncodingError)` * EncodingError: erro de codificação detectado. Lançado quando um modelo Codable não pode ser codificado para JSON. * `canParseResponse` Lançado quando uma resposta da instância não pode ser analisada no formato esperado. * `URL inválido` Lançado quando um URL não pode ser formado. Por exemplo, se a cadeia de caracteres contiver caracteres que são ilegais em um URL ou for uma cadeia de caracteres vazia. * `ausenteAttachmentMetadata` Lançado quando o cabeçalho de metadados do anexo está ausente. * `ausenteConfiguraçãoDeServiço` Lançado quando uma configuração de serviço esperada está ausente. * `ausenteSysID` Lançado quando um parâmetro sys_id esperado está ausente. * `network(NetworkServiceError)` * genericError(cadeia de caracteres) * operaçãoCancelada * serviçoDesabilitado * serverError(Erro) * systemError (Erro) Lançado quando um serviço de rede encontrou um erro. {#NAttServiOS-upload_O_O_O_O__NowDataErroriOS-ul-enum} | [Tabela 31. Parâmetros] {#NAttServiOS-upload_O_O_O_O__table_n5z_mpx_spb} {#NAttServiOS-upload_O_O_O_O__table_o5z_mpx_spb__entry__2} | Tipo | Descrição | |-|-| | Nenhum(a) | | [Tabela 32. Retorna] {#NAttServiOS-upload_O_O_O_O__table_o5z_mpx_spb} O exemplo de código a seguir mostra como chamar esta função. typealias ProgressUpdate = (_ bytesWritten: Int64, _ totalBytesWritten: Int64, _ totalBytesExpectedToWrite: Int64) -> Void let image = UIImage(named: "photo.png") let data = image.pngData() let recordSysId = "" // Sys_id of the record on the SN instance let config = NowAttachmentUploadConfiguration( tableName: "tableName", recordSysId: recordSysId, fileName: "photo.png", contentType: "image/png", encryptionContext: nil) private func uploadFile( data: Data, config: NowAttachmentUploadConfiguration, progress: @escaping ProgressUpdate) { attachmentService.upload(data: data, configuration: config, progressUpdate: progress) { (result) in DispatchQueue.main.async { [weak self] in switch result { case .success(let response) do { let data = try JSONEncoder().encode(response) // Upload file successfully, return data } catch // Upload file decode failed, return error } case .failure(let error): // Upload file failed, return NowDataError } } } ## NowAttachmentService - upload (dados: dados, configuração: NowAttachmentUploadConfiguration, progressUpdate: @escaping ProgressUpdate) {#ariaid-title18} Carrega os dados do anexo e os anexa a um registro em uma tabela conforme especificado na configuração de carregamento. O retorno de chamada ProgressUpdate fornece informações de andamento de carregamento que você pode usar para fornecer feedback de IU. Nota: Este método foi descontinuado. Em vez disso, você deve usar a implementação assíncrona/aguardar do método. {#NAttServiOS-upload_O_O_O__table_ptn_lnx_spb__entry__3} | Nome | Tipo | Descrição | |-|-|-| | dados | Dados | Anexo a ser carregado. O tamanho dos dados e o tipo de anexo que você pode carregar são controlados por sua instância ServiceNow. | | configuração | [NowAttachmentUploadConfiguration](https://servicenow-prod.fluidtopics.net/VSWs2mMUqhRTaAwVPhdN1Q#NowAttachUploadConfigiOSStruct "A estrutura NowAttachmentUploadConfiguration permite que você defina as informações de configuração de um anexo que você está carregando para sua instância ServiceNow.") | Informações de configuração que definem os parâmetros de carregamento do anexo, como: * Tabela e registro aos quais o arquivo será anexado * Nome do arquivo de anexo * Tipo de anexo * Se o arquivo está criptografado | | progressoAtualizar | @escaping ProgressUpdate | Manipulador de conclusão a ser executado depois que o anexo for recuperado. Valores de retorno para o manipulador de conclusão: ProgressUpdate --- Retorna o andamento atual do upload. Isso é chamado várias vezes até que o processo de carregamento seja concluído. `ProgressUpdate = (_bytesWritten: Int64, _totalBytesWritten: Int64, _totalBytesExpectedToWrite: Int64) -> Void` | [Tabela 33. Parâmetros] {#NAttServiOS-upload_O_O_O__table_ptn_lnx_spb} {#NAttServiOS-upload_O_O_O__table_qtn_lnx_spb__entry__2} | Tipo | Descrição | |-|-| | AnyPublisher​\<[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/phLzcUqCpZb1cYO_ycbXMA#NowAttachmentMetadataiOSStructure "A estrutura NowAttachmentMetadata fornece funções que permitem codificar e gerenciar metadados de anexo."), NowDataError\> | Sucesso: [NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/phLzcUqCpZb1cYO_ycbXMA#NowAttachmentMetadataiOSStructure "A estrutura NowAttachmentMetadata fornece funções que permitem codificar e gerenciar metadados de anexo.") - Objeto que contém os metadados do anexo solicitado. Falha: NowDataError * `accessToken(AccessTokenProviderError)` * AccessTokenProviderError: o código ou a mensagem de erro do provedor de token de acesso. * accessTokenRetrievalFailed * userSessionError(_ erro: Erro) Lançado quando há um erro no token de acesso. * `attachmentValidation` Lançado quando um anexo falha na validação. * `BadResponse(statusCode: HTTPStatusCode)` * HTTPStatusCode: Código de status recebido da instância. Lançado quando uma solicitação retorna uma resposta inesperada * `canDecodeModel(DecodingError)` * DecodingError: erro de decodificação detectado. Lançado quando um modelo Codable não pode ser decodificado do JSON. * `canDecodeProperty(tipo: qualquer, de: cadeia de caracteres)` * type: tipo encapsulado para decodificar a partir de uma cadeia de caracteres. * from: cadeia de caracteres a ser decodificada para o tipo especificado. Lançado quando um valor encapsulado em cadeia de caracteres não pode ser decodificado do JSON. * `can'tEncodeModel(EncodingError)` * EncodingError: erro de codificação detectado. Lançado quando um modelo Codable não pode ser codificado para JSON. * `canParseResponse` Lançado quando uma resposta da instância não pode ser analisada no formato esperado. * `URL inválido` Lançado quando um URL não pode ser formado. Por exemplo, se a cadeia de caracteres contiver caracteres que são ilegais em um URL ou for uma cadeia de caracteres vazia. * `ausenteAttachmentMetadata` Lançado quando o cabeçalho de metadados do anexo está ausente. * `ausenteConfiguraçãoDeServiço` Lançado quando uma configuração de serviço esperada está ausente. * `ausenteSysID` Lançado quando um parâmetro sys_id esperado está ausente. * `network(NetworkServiceError)` * genericError(cadeia de caracteres) * operaçãoCancelada * serviçoDesabilitado * serverError(Erro) * systemError (Erro) Lançado quando um serviço de rede encontrou um erro. {#NAttServiOS-upload_O_O_O__NowDataErroriOS-ul-enum} | [Tabela 34. Retorna] {#NAttServiOS-upload_O_O_O__table_qtn_lnx_spb} O exemplo de código a seguir mostra como chamar esta função. typealias ProgressUpdate = (_ bytesWritten: Int64, _ totalBytesWritten: Int64, _ totalBytesExpectedToWrite: Int64) -> Void let image = UIImage(named: "photo.png") let data = image.pngData() let recordSysId = "" // Sys_id of the record on the SN instance let config = NowAttachmentUploadConfiguration( tableName: "tableName", recordSysId: recordSysId, fileName: "photo.png", contentType: "image/png", encryptionContext: nil) private func uploadFile(data: Data, config: NowAttachmentUploadConfiguration, progress: @escaping ProgressUpdate) { let publisher = attachmentService.upload(data: data, configuration: config, progressUpdate: progress) publisher .receive(on: DispatchQueue.main) .encode(encoder: JSONEncoder()) .sink { [weak self] completion in if case let .failure(error) = completion { // Upload file failed, return NowDataError } } receiveValue: { [weak self] (data) in // Upload file successfully, return data } .store(in: &subscriptions) }