Menyelesaikan tugas

Dokumen ini mengasumsikan Anda memahami cara membuat dan menggunakan tugas. Panduan ini memberikan contoh spesifik tentang cara menyelesaikan tugas pengiriman sebagai berikut:

  • Menutup tugas: Menutup tugas pengiriman akan mengubah statusnya menjadi CLOSED dan menunjukkan bahwa tugas tersebut tidak lagi aktif.

  • Menetapkan hasil tugas: Setelah tugas ditutup, Anda lalu menyelesaikannya dengan menetapkan hasilnya ke SUCCEEDED atau FAILED. Ini adalah bagian penting dari penyelesaian tugas untuk menunjukkan hasil pengiriman dalam berbagi perjalanan dan memastikan penagihan yang benar untuk layanan Fleet Engine.

Menutup tugas

Anda dapat menutup tugas dengan cara berikut:

  • Perbarui status perhentian untuk kendaraan. Anda menghapus perhentian dari kendaraan, yang pada gilirannya akan menutup semua tugas yang terkait dengan perhentian tersebut. Lihat Memperbarui status perhentian untuk mengetahui detailnya.
  • Hapus tugas dari daftar perhentian kendaraan. Tindakan ini mencakup pembaruan daftar tugas untuk perhentian, tetapi dengan tugas yang ditutup tidak lagi menjadi bagian dari daftar. Lihat Memperbarui urutan tugas di Memperbarui tugas.
  • Tetapkan status tugas ke CLOSED. Ini hanya dapat dilakukan pada tugas yang tidak ditugaskan ke kendaraan. Bagian ini menunjukkan pendekatan ini.

Setelah menutup tugas, Anda tidak dapat membukanya kembali.

Penutupan tugas tidak menunjukkan keberhasilan atau kegagalannya. Hal ini menunjukkan bahwa tugas tidak lagi dianggap sedang berlangsung. Untuk menunjukkan hasil sebenarnya dari tugas dan menampilkannya untuk tujuan Pelacakan Fleet dan berbagi perjalanan, Anda harus menunjukkan hasil tugas yang sebenarnya. Lihat Menetapkan hasil tugas di bawah.

Kolom tugas untuk menutup tugas

Bagian ini mendokumentasikan kolom wajib diisi untuk ditetapkan saat menutup tugas. Mesin perangkat mengabaikan semua kolom lain di entity untuk update.

Kolom wajib diisi Nilai
state State.CLOSED

Menutup tugas secara langsung

Contoh berikut menunjukkan cara menetapkan tugas yang belum ditetapkan ke status tertutup, baik di gRPC atau menggunakan panggilan permintaan REST HTTP ke UpdateTask

gRPC

 static final String PROJECT_ID = "my-delivery-co-gcp-project";
 static final String TASK_ID = "task-8241890";

 DeliveryServiceBlockingStub deliveryService =
   DeliveryServiceGrpc.newBlockingStub(channel);

 // Task settings
 String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
 Task task = Task.newBuilder()
   .setName(taskName)
   .setState(Task.State.CLOSED) // You can only directly CLOSE a
   .build();                    // task that is NOT assigned to a vehicle.

 // Task request
 UpdateTaskRequest updateTaskRequest =
   UpdateTaskRequest.newBuilder()  // No need for the header
       .setTask(task)
       .setUpdateMask(FieldMask.newBuilder().addPaths("state"))
       .build();

 try {
   Task updatedTask = deliveryService.updateTask(updateTaskRequest);
 } catch (StatusRuntimeException e) {
   Status s = e.getStatus();
   switch (s.getCode()) {
      case NOT_FOUND:
        break;
      case PERMISSION_DENIED:
        break;
   }
   return;
 }

REST

PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<id>?updateMask=state

  • <id> adalah ID unik untuk tugas.
  • Header permintaan harus berisi kolom Authorization dengan nilai Bearer <token>, dengan <token> diterbitkan oleh server Anda sesuai dengan panduan yang dijelaskan dalam Service account Role dan JSON Web tokens.
  • Anda harus menyertakan entitas Task dalam isi permintaan

Contoh perintah curl:

 # Set JWT, PROJECT_ID, and TASK_ID in the local environment
 curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}?updateMask=state,taskOutcome,taskOutcomeTime" \
   -H "Content-type: application/json" \
   -H "Authorization: Bearer ${JWT}" \
   --data-binary @- << EOM
 {
   "state": "CLOSED",
   "taskOutcome": "SUCCEEDED",
   "taskOutcomeTime": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
 }
 EOM

Menetapkan hasil tugas

Untuk menunjukkan hasil sebenarnya dari suatu tugas, Anda menetapkan hasil untuk tugas tertutup ke SUCCEEDED atau FAILED. Tugas harus ditutup sebelum Anda menetapkan hasilnya. Fleet Engine hanya menagih biaya untuk tugas pengiriman dengan status SUCCEEDED.

Detail hasil tugas

Tugas juga memberikan detail tambahan tentang hasil tugas. Anda dapat menetapkannya secara langsung dan Fleet Engine mengikuti setelan Anda:

  • Lokasi hasil tugas: Fleet Engine secara otomatis mengisi lokasi hasil tugas dengan lokasi kendaraan terakhir yang diketahui. Anda dapat memberikannya jika mau.
  • Waktu hasil tugas: Fleet Engine tidak mengisi kolom ini, tetapi tersedia untuk Anda tetapkan.

Anda dapat menggunakan salah satu pendekatan berikut untuk menetapkan task_outcome_location dan task_outcome_time:

  • Perbarui dalam permintaan yang sama yang menetapkan hasil tugas.
  • Perbarui nanti, setelah Anda menetapkan hasil tugas.
  • Ubah lagi setelah ditetapkan.

Fleet Engine mencegah pembaruan berikut yang terkait dengan hasil tugas:

  • Anda tidak dapat mengubah hasil tugas setelah ditetapkan ke SUCCEEDED atau FAILED.
  • Anda tidak dapat menetapkan lokasi atau waktu hasil tugas untuk tugas tanpa hasil yang ditetapkan.

Kolom tugas untuk menetapkan hasil

Bagian ini mendokumentasikan kolom wajib dan opsional yang akan ditetapkan saat menetapkan hasil tugas. Fleet Engine mengabaikan kolom lain dalam entitas untuk pembaruan.

Kolom wajib diisi Nilai
taskOutcome Outcome.SUCCEEDED atau Outcome.FAILED

Kolom opsionalNilai
taskOutcomeLocation Lokasi tempat tugas diselesaikan. Jika tidak ditetapkan, Fleet Engine akan menetapkannya secara default ke lokasi kendaraan terakhir.
taskOutcomeTime Stempel waktu saat tugas selesai.

Contoh hasil tugas

Contoh berikut menunjukkan cara menggunakan library gRPC Java dan panggilan REST HTTP ke UpdateTask untuk menetapkan hasil tugas ke SUCCEEDED dan menetapkan lokasi tempat tugas diselesaikan.

gRPC

 static final String PROJECT_ID = "my-delivery-co-gcp-project";
 static final String TASK_ID = "task-8241890";

 DeliveryServiceBlockingStub deliveryService =
   DeliveryServiceGrpc.newBlockingStub(channel);

 // Task settings
 String taskName = "providers/" + PROJECT_ID + "/tasks/" + TASK_ID;
 Task task = Task.newBuilder()
   .setName(taskName)
   .setTaskOutcome(TaskOutcome.SUCCEEDED)
   .setTaskOutcomeTime(now())
   .setTaskOutcomeLocation(               // Grand Indonesia East Mall
     LocationInfo.newBuilder().setPoint(
       LatLng.newBuilder().setLatitude(-6.195139).setLongitude(106.820826)))
   .build();

 // Task request
 UpdateTaskRequest updateTaskRequest =
   UpdateTaskRequest.newBuilder()  // No need for the header
       .setTask(task)
       .setUpdateMask(FieldMask.newBuilder().addPaths("task_outcome", "task_outcome_time", "task_outcome_location"))
       .build();

 try {
   Task updatedTask = deliveryService.updateTask(updateTaskRequest);
 } catch (StatusRuntimeException e) {
   Status s = e.getStatus();
   switch (s.getCode()) {
      case NOT_FOUND:
        break;
      case PERMISSION_DENIED:
        break;
   }
   return;
 }

REST

PATCH https://fleetengine.googleapis.com/v1/providers/<project_id>/tasks/<id>?updateMask=taskOutcome,taskOutcomeTime,taskOutcomeLocation

  • <id> adalah ID unik untuk tugas.
  • Header permintaan harus berisi kolom Authorization dengan nilai Bearer <token>, dengan <token> dikeluarkan oleh server Anda sesuai dengan panduan yang dijelaskan dalam Peran akun layanan dan JSON Web token.
  • Isi permintaan harus berisi entitas Task.
 # Set JWT, PROJECT_ID, and TASK_ID in the local environment
 curl -X PATCH "https://fleetengine.googleapis.com/v1/providers/${PROJECT_ID}/tasks/${TASK_ID}?updateMask=taskOutcome,taskOutcomeTime,taskOutcomeLocation" \
   -H "Content-type: application/json" \
   -H "Authorization: Bearer ${JWT}" \
   --data-binary @- << EOM
 {
   "taskOutcome": "SUCCEEDED",
   "taskOutcomeTime": "$(date -u +"%Y-%m-%dT%H:%M:%SZ")",
   "taskOutcomeLocation": {
     "point": {
       "latitude": -6.195139,
       "longitude": 106.820826
     }
   }
 }
 EOM

Langkah berikutnya