Aufgaben abschließen

In diesem Dokument wird davon ausgegangen, dass Sie wissen, wie Sie Aufgaben erstellen und verwenden. Es enthält konkrete Beispiele für die folgenden Aufgaben zum Abschließen von Sendungen:

  • Aufgabe schließen: Wenn Sie eine Versandaufgabe schließen, ändert sich ihr Status in CLOSED. Das bedeutet, dass die Aufgabe nicht mehr aktiv ist.

  • Ergebnis der Aufgabe festlegen: Wenn eine Aufgabe geschlossen wurde, können Sie sie abschließen, indem Sie ihr Ergebnis auf SUCCEEDED oder FAILED festlegen. Das ist ein wichtiger Schritt, um eine Aufgabe abzuschließen, das Ergebnis der Ausführung in der Routenfreigabe zu präsentieren und eine korrekte Abrechnung des Fleet Engine-Dienstes zu gewährleisten.

Aufgabe schließen

Sie haben folgende Möglichkeiten, eine Aufgabe zu schließen:

  • Status des Stopps für das Fahrzeug aktualisieren Sie entfernen den Stopp vom Fahrzeug. Dadurch werden alle mit dem Stopp verknüpften Aufgaben geschlossen. Weitere Informationen finden Sie unter Status von Haltestellen aktualisieren.
  • Aufgabe aus der Liste der Fahrzeugstopps entfernen: Dazu muss die Liste der Aufgaben für den Stopp aktualisiert werden, wobei die abgeschlossene Aufgabe nicht mehr Teil der Liste ist. Weitere Informationen finden Sie unter Aufgaben aktualisieren im Abschnitt „Aufgabenreihenfolge aktualisieren“.
  • Setzen Sie den Aufgabenstatus auf CLOSED. Dies ist nur bei Aufgaben möglich, die nicht Fahrzeugen zugewiesen sind. In diesem Abschnitt wird dieser Ansatz beschrieben.

Wenn Sie eine Aufgabe schließen, können Sie sie nicht wieder öffnen.

Der Abschluss einer Aufgabe bedeutet nicht, dass sie erfolgreich oder fehlgeschlagen ist. Das bedeutet, dass die Aufgabe nicht mehr als „in Bearbeitung“ gilt. Damit das tatsächliche Ergebnis einer Aufgabe angezeigt wird, müssen Sie es angeben. Das ist für die Flottenverfolgung und die Weitergabe von Routen erforderlich. Weitere Informationen finden Sie unten unter Ergebnis der Aufgabe festlegen.

Aufgabenfelder zum Schließen von Aufgaben

In diesem Abschnitt werden die erforderlichen Felder dokumentiert, die beim Schließen einer Aufgabe festgelegt werden müssen. Alle anderen Felder in der Entität werden von Fleet Engine für das Update ignoriert.

Pflichtfeld Wert
state State.CLOSED

Aufgaben direkt schließen

Die folgenden Beispiele zeigen, wie Sie eine nicht zugewiesene Aufgabe in einen geschlossenen Status versetzen können, entweder in gRPC oder mit einem HTTP-REST-Anfrageaufruf an 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> ist eine eindeutige Kennung für die Aufgabe.
  • Der Anfrageheader muss ein Feld Authorization mit dem Wert Bearer <token> enthalten, wobei <token> von Ihrem Server gemäß den Richtlinien unter Dienstkontorollen und JSON Web Tokens ausgestellt wird.
  • Sie müssen im Anfragetext eine Task-Einheit angeben.

Beispiel eines curl-Befehls:

 # 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

Ergebnis der Aufgabe festlegen

Um das tatsächliche Ergebnis einer Aufgabe anzugeben, legen Sie das Ergebnis für geschlossene Aufgaben auf SUCCEEDED oder FAILED fest. Eine Aufgabe muss geschlossen werden, bevor Sie ihr Ergebnis festlegen können. Fleet Engine berechnet nur Zustellaufgaben mit dem Status SUCCEEDED.

Details zum Ergebnis der Aufgabe

Außerdem enthalten sie zusätzliche Details zum Ergebnis der Aufgabe. Sie können diese Einstellungen direkt festlegen und Fleet Engine berücksichtigt sie:

  • Standort des Ergebnisses der Aufgabe: Fleet Engine füllt den Standort des Ergebnisses der Aufgabe automatisch mit dem letzten bekannten Fahrzeugstandort aus. Sie können stattdessen auch diese angeben.
  • Zeitpunkt des Aufgabenergebnisses: Dieses Feld wird von Fleet Engine nicht ausgefüllt, kann aber von Ihnen festgelegt werden.

Sie haben folgende Möglichkeiten, task_outcome_location und task_outcome_time festzulegen:

  • Aktualisieren Sie sie in derselben Anfrage, in der das Ergebnis der Aufgabe festgelegt wird.
  • Später aktualisieren, nachdem Sie das Ergebnis der Aufgabe festgelegt haben.
  • Sie können sie nach dem Festlegen noch einmal ändern.

Fleet Engine verhindert die folgenden Aktualisierungen im Zusammenhang mit Ergebnissen von Aufgaben:

  • Sie können das Ergebnis einer Aufgabe nicht mehr ändern, nachdem es auf SUCCEEDED oder FAILED festgelegt wurde.
  • Für Aufgaben ohne festgelegtes Ergebnis können Sie keinen Ergebnisort oder keine Ergebniszeit festlegen.

Aufgabenfelder zum Festlegen des Ergebnisses

In diesem Abschnitt werden die erforderlichen und optionalen Felder beschrieben, die beim Festlegen eines Aufgabenergebnisses festgelegt werden müssen. Fleet Engine ignoriert andere Felder im Element für die Aktualisierung.

Pflichtfeld Wert
taskOutcome Outcome.SUCCEEDED oder Outcome.FAILED

Optionales FeldWert
taskOutcomeLocation Der Ort, an dem die Aufgabe erledigt wurde. Wenn nichts festgelegt ist, wird von Fleet Engine standardmäßig der letzte Standort des Fahrzeugs verwendet.
taskOutcomeTime Der Zeitstempel für den Abschluss der Aufgabe.

Beispiele für Ergebnisse von Aufgaben

Im folgenden Beispiel wird gezeigt, wie Sie die Java-gRPC-Bibliothek und einen HTTP-REST-Aufruf an UpdateTask verwenden, um das Ergebnis einer Aufgabe auf SUCCEEDED und den Ort festzulegen, an dem die Aufgabe abgeschlossen wurde.

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> ist eine eindeutige Kennung für die Aufgabe.
  • Der Anfrageheader muss ein Feld Authorization mit dem Wert Bearer <token> enthalten, wobei <token> von Ihrem Server gemäß den Richtlinien unter Dienstkontorollen und JSON Web Tokens ausgestellt wird.
  • Der Anfragetext muss eine Task-Entität enthalten.
 # 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

Nächste Schritte