Interface NowAttachmentService : Android

L’interface NowAttachmentService fournit des fonctions qui permettent la manipulation des pièces jointes de fichier et de leurs métadonnées associées.

Tableau 1. Propriétés

Nom	Type	Description
configuration	Configuration Now ServiceConfiguration	Configuration à associer au service.

NowAttachmentService : attachment(sysId : String, validateAttachment : Boolean = true)

Récupère la pièce jointe avec le sys_id spécifié et valide éventuellement la pièce jointe en comparant le hachage calculé de la pièce jointe au hachage attendu.

Tableau 2. Paramètres

Nom	Type	Description
sysId	Chaîne	Sys_id de la pièce jointe à récupérer. Il s’agit du sys_id de la pièce jointe sur votre ServiceNow instance.
validateAttachment	Booléen	Marqueur indiquant s’il faut valider la pièce jointe. Valeurs valides : vrai : validez la pièce jointe. faux : ne pas valider la pièce jointe. Valeur par défaut : true

Tableau 3. Renvoie

Type	Description
Appeler<NowAttachment>	Objet NowAttachment qui contient la pièce jointe demandée.

fun getAttachment(sysId: String, isValidateAttachment: Boolean) { 
  val call = attachmentService.attachment(sysId, isValidateAttachment) 
  call.enqueue( 
    { response -> 
      val attachment: NowAttachment? = response.body 
    }, 
      { nowDataError -> handleError(nowDataError) } 
  ) 
}

NowAttachmentService : attachmentMetadata(sysId : chaîne)

Récupère les métadonnées de la pièce jointe associée au sys_id spécifié.

Tableau 4. Paramètres

Nom	Type	Description
sysId	Chaîne	Sys_id de la pièce jointe dont vous souhaitez récupérer les métadonnées.

Tableau 5. Renvoie

Type	Description
Appeler<NowAttachmentMetadata>	Objet contenant les métadonnées de la pièce jointe spécifiée.

fun fetchMetadata(sysId: String) { 
  val call = attachmentService.attachmentMetadata(sysId) 
  call.enqueue(
    { response -> 
      val metadata: NowAttachmentMetadata? = response.body 
    },
    { nowDataError -> handleError(nowDataError) } 
  )
}

NowAttachmentService : attachmentMetadata(filter : Filter ? = null, limit : Int ? = null)

Récupère les métadonnées de toutes les pièces jointes qui répondent aux critères spécifiés.

Tableau 6. Paramètres

Nom	Type	Description
filtre	Filtrer	Facultatif. Chaîne de requête à utiliser pour filtrer les pièces jointes dont les métadonnées doivent être renvoyées. Par défaut : null : renvoie les métadonnées pour toutes les pièces jointes disponibles. Prend en considération le limit paramètre.
limite	Entier	Facultatif. Nombre maximal de métadonnées du fichier de pièce jointe à renvoyer. Par défaut : null : renvoie toutes les métadonnées qui répondent aux spécifications du filter paramètre.

Tableau 7. Renvoie

Type	Description
Call<List<NowAttachmentMetadata>>	Liste des objets contenant les métadonnées des pièces jointes correspondantes.

fun fetchMultipleMetadata(filterQuery: String, limit: Int) { 
  val call = attachmentService.attachmentMetadata(Filter(filterQuery), limit) 
  call.enqueue( 
    { response -> 
      val metadataList: List<NowAttachmentMetadata>? = response.body 
    },
    { nowDataError -> handleError(nowDataError) } 
  )
}

NowAttachmentService : attachmentMetadataPaginator(filter : Filter ? = null, limit : Int ? = null)

Récupère les métadonnées de toutes les pièces jointes qui répondent aux critères spécifiés et crée un paginateur pour l’itération à travers les pages des métadonnées renvoyées.

Vous pouvez utiliser ce paginateur pour naviguer dans les métadonnées renvoyées, en effectuant des opérations de navigation telles que l’extraction de la première, de la dernière, de la page précédente ou de la page suivante, ou en vérifiant s’il existe une page suivante ou précédente.

Tableau 8. Paramètres

Nom	Type	Description
filtre	Filtrer	Facultatif. Chaîne de requête à utiliser pour filtrer les pièces jointes dont les métadonnées doivent être renvoyées. Par défaut : null : renvoie les métadonnées pour toutes les pièces jointes disponibles. Prend en considération le limit paramètre.
limite	Entier	Facultatif. Nombre maximal de métadonnées du fichier de pièce jointe à renvoyer. Par défaut : null : renvoie toutes les métadonnées qui répondent aux spécifications du filter paramètre.

Tableau 9. Renvoie

Type	Description
Paginateur <NowAttachmentMetadata>	Réussite : objet du paginateur avec les pages spécifiées des métadonnées. Échec : objet NowDataError.

L’exemple de code suivant montre comment appeler cette fonction.

suspend fun createAttachmentMetadataPaginator() {
  val filterQuery: String = "content_type=text/plain"
  val filter = filterQuery.let(::Filter)
  val limit = 10
  val paginator = nowServiceManager.getNowAttachmentService()?.attachmentMetadataPaginator(filter, limit)
    ?.observe(object : PaginatorCallBack<NowAttachmentMetadata> {
      override fun onFailure(e: NowDataError) {
        handleError(e)
      }

      override fun onSuccess(response: Response<List<NowAttachmentMetadata>>) {
        handleResponse(response)
      }

    })
    ?: throw Exception("Response is null")
}

NowAttachmentService : delete(sysId : chaîne)

Supprime la pièce jointe avec le sys_id spécifié.

Tableau 10. Paramètres

Nom	Type	Description
sysId	Chaîne	Sys_id de la pièce jointe à supprimer.

Tableau 11. Renvoie

Type	Description
Appeler<ByteArray>	Réussite : rien n’est retourné. Échec : NowDataError renvoyé.

fun deleteAttachment(sysId: String) { 
  val call = attachmentService.delete(sysId) 
  call.enqueue( 
    { response -> handleResponse(response) }, 
    { nowDataError -> handleError(nowDataError) } 
  )
} 

NowAttachmentService : upload(données : ByteArray, configuration : NowAttachmentUploadConfiguration)

Récupère les métadonnées de toutes les pièces jointes qui répondent aux critères spécifiés et crée un paginateur pour l’itération à travers les pages des métadonnées renvoyées.

Tableau 12. Paramètres

Nom	Type	Description
données	Tableau d’octets	Métadonnées à charger et à associer à la pièce jointe spécifiée dans l’objet de configuration.
configuration	NowAttachmentUploadConfiguration	Chargez les paramètres de configuration.

Tableau 13. Renvoie

Type	Description
NowAttachmentMetadata (en anglais seulement)	Métadonnées chargées.

fun uploadAttachment(tableName: String, recordSysId: String, fileName: String) { 
  val bitmap = BitmapFactory.decodeResource(resources, R.drawable.test_image) 
  val data = bitmap.compress(ImageType.JPEG) 
  val contentType = "image/jpg" 
  val config = NowAttachmentUploadConfiguration(tableName, recordSysId, fileName, contentType) 
  val call = attachmentService.upload(data, config) 
 
  call.enqueue( 
    { response -> 
      val uploadedAttachmentMetadata: NowAttachmentMetadata? = response.body 
    },
    { nowDataError -> handleError(nowDataError) } 
  )
}