حذف البيانات

يُعد حذف البيانات جزءًا أساسيًا من عمليات الإنشاء والقراءة والتعديل والحذف (CRUD) في Health Connect. يوضّح لك هذا الدليل كيف يمكنك حذف السجلّات بطريقتَين.

الحذف باستخدام معرّفات السجلات

يمكنك حذف السجلات باستخدام قائمة بالمعرّفات الفريدة، مثل معرّف السجلّ ومعرّف سجلّ العميل الخاص بتطبيقك. استخدِم deleteRecords، وقدِّم له قائمتَين من Strings، إحداهما لمعرّفات السجلات والأخرى لمعرّفات العملاء. إذا كان لديك رقم تعريف واحد فقط، يمكنك ضبط emptyList() في القائمة الأخرى.

يوضّح مثال الرمز البرمجي التالي كيفية حذف بيانات الخطوات باستخدام أرقام التعريف الخاصة بها:

suspend fun deleteStepsByUniqueIdentifier(
    healthConnectClient: HealthConnectClient,
    idList: List<String>
) {
    try {
        healthConnectClient.deleteRecords(
            StepsRecord::class,
            idList = idList,
            clientRecordIdsList = emptyList()
        )
    } catch (e: Exception) {
        // Run error handling here
    }
}

الحذف باستخدام نطاق زمني

يمكنك أيضًا حذف البيانات باستخدام نطاق زمني كفلتر. استخدِم deleteRecords، وقدِّم له عنصر TimeRangeFilter يتضمّن قيمتَي الطابع الزمني للبدء والانتهاء.

يوضّح مثال الرمز البرمجي التالي كيفية حذف بيانات الخطوات في وقت معيّن:

suspend fun deleteStepsByTimeRange(
    healthConnectClient: HealthConnectClient,
    startTime: Instant,
    endTime: Instant
) {
    try {
        healthConnectClient.deleteRecords(
            StepsRecord::class,
            timeRangeFilter = TimeRangeFilter.between(startTime, endTime)
        )
    } catch (e: Exception) {
        // Run error handling here
    }
}