本頁面由 Cloud Translation API 翻譯而成。

完成工作

本文假設您已瞭解如何建立及使用工作。並提供如何完成運送工作任務的具體範例，如下所示：

關閉工作：關閉出貨工作會將其狀態變更為 CLOSED，並表示該工作已不再有效。
設定工作結果：工作關閉後，將結果設為 SUCCEEDED 或 FAILED。這是完成工作的重要步驟，可在旅程分享中顯示運送結果，並確保 Fleet Engine 服務的帳單正確無誤。

關閉工作

您可以透過下列方式關閉工作：

更新車輛的停靠狀態。您從以下位置移除停靠站：此時車輛會關閉所有與停靠站相關的工作詳情請參閱「更新停靠站狀態」。
將工作從車輛停靠站清單中移除。包括更新停止工作清單，但包含已關閉的任務較新的部分請參閱更新工作中的「更新工作順序」。
將工作狀態設為 CLOSED。只能處理非工作型工作。本節說明這個方法。

關閉工作後，您可能無法重新開啟。

關閉工作並不代表工作成功或失敗。它代表不會再將該工作視為進行中。為了指出工作的實際結果，且有資格在車隊追蹤及如果為了分享流程，您必須指出工作的實際結果。詳情請見請在下方設定工作結果。

關閉工作的工作欄位

本節說明關閉工作時必須設定的欄位。機群引擎會忽略更新實體中的所有其他欄位。

必填欄位	值
`state`	`State.CLOSED`

直接關閉工作

以下範例說明如何將未指派的工作設為關閉狀態。，或使用對 UpdateTask 的 HTTP REST 要求呼叫

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> 是工作專屬 ID。
要求標頭必須包含 Authorization 欄位，當中須有相應的值 不記名 <token>，其中 <token> 是由您的伺服器核發服務帳戶角色中所述的指南，以及 JSON Web 權杖。
您必須在要求主體中加入 Task 實體

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

設定工作結果

為了表示工作的實際結果，請設定已關閉工作的結果 SUCCEEDED 或 FAILED。必須先關閉工作，才能設定其結果。Fleet Engine 僅針對狀態為 SUCCEEDED。

工作結果詳細資料

工作也會提供關於工作結果的其他詳細資料。您可以設定且 Fleet Engine 會遵循您的設定：

工作結果位置：Fleet Engine 會自動填入工作最後已知車輛位置的結果位置。您可以提供這項資訊。
工作結果時間：Fleet Engine 未填入這個欄位，但

您可以使用下列任一方法設定 task_outcome_location 和 task_outcome_time：

在設定工作結果的相同要求中進行更新。
請在設定工作結果後稍後再更新。
設定完成後，請再次修改。

Fleet Engine 禁止下列工作結果相關更新：

工作結果設為 SUCCEEDED 後即無法修改 FAILED。
在沒有工作的情況下，您無法設定工作結果位置或結果時間 就能獲得固定結果

設定結果的工作欄位

本節記錄了在設定工作結果Fleet Engine 會忽略實體中的其他欄位。

必填欄位	值
`taskOutcome`	`Outcome.SUCCEEDED` 或 `Outcome.FAILED`

選填欄位	值
`taskOutcomeLocation`	完成工作的地點。如未設定，機群引擎會預設為上次開車前往的車輛位置。
`taskOutcomeTime`	工作完成時的時間戳記。

任務結果範例

以下範例說明如何使用 Java gRPC 程式庫和 HTTP 向 UpdateTask 發出的 REST 呼叫，可以將工作結果設為 SUCCEEDED，並設定工作完成的位置

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> 是工作的專屬 ID。
要求標頭必須包含 Authorization 欄位，當中須有相應的值 不記名 <token>，其中 <token> 是由您的伺服器核發服務帳戶角色中所述的指南，以及 JSON Web 權杖。
要求主體必須包含 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

後續步驟

尋找工作