plannerAssignments-RessourcentypplannerAssignments resource type

Wichtig

APIs unter der /beta Version in Microsoft Graph können Änderungen unterworfen werden.APIs under the /beta version in Microsoft Graph are subject to change. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt.Use of these APIs in production applications is not supported.

Die plannerAssignments -Ressource stellt Zuordnungen einer plannerTask -Ressource dar.The plannerAssignments resource represents assignments of a plannerTask resource. Dieser Typ ist ein offener Typ.This type is an open type. Jeder Eigenschaften Name in diesem Typ ist die ID eines Benutzerobjekts, dem eine Aufgabe zugewiesen ist.Each property name in this type is the ID of a user object a task is assigned to. Die Benutzer können Aufgaben zugewiesen werden, indem Sie neue Eigenschaften mit ihrer ID erstellen, wobei ein plannerassignment -Objekt mit einer orderHint-Eigenschaft als Wert aufgefüllt wird.The users can be assigned to tasks with creating new properties named with their ID, with a plannerassignment object with orderHint property populated as the value. Die zugewiesenen können von der Aufgabe aufgehoben werden, indem Sie den propety mit der ID auf NULL festlegen.The assignees can be unassigned from the task by setting the propety named with their ID to null.

EigenschaftenProperties

Eigenschaften eines geöffneten Typs können vom Client definiert werden.Properties of an Open Type can be defined by the client. In diesem Fall muss der Client die IDs der zugewiesenen Benutzer als Eigenschaftsnamen bereitstellen.In this case though, the client must provide assigned user's IDs as property names. Die Eigenschaft muss auf ein plannerAssignment -Objekt festgelegt sein, um Empfänger zu erstellen oder zu ändern und um Sie zu entfernen.The property must be set to a plannerAssignment object to create or modify assignees, and to null to remove them.

Beispiel:Example:

{
  "ca2a1df2-e36b-4987-9f6b-0ea462f4eb47": null,
  "4e98f8f1-bb03-4015-b8e0-19bb370949d8": { 
      "@odata.type": "microsoft.graph.plannerAssignment",
      "orderHint": "String"
    }
}

In diesem Beispiel wird der Benutzer mit der ID ca2a1df2-e36b-4987-9f6b-0ea462f4eb47 aus der Liste der Empfänger der Aufgabe entfernt, während die Reihenfolge des Empfängers mit der Benutzer-ID 4e98f8f1-bb03-4015-b8e0-19bb370949d8 geändert wird.This example removes user with ID ca2a1df2-e36b-4987-9f6b-0ea462f4eb47 from the assignees list of the task, while changing the order of the assignee with user ID 4e98f8f1-bb03-4015-b8e0-19bb370949d8. Wenn die Aufgabe nicht bereits dem Benutzer mit der ID 4e98f8f1-bb03-4015-b8e0-19bb370949d8 zugewiesen ist, wird die Aufgabe diesem Benutzer durch Aktualisieren der Zuordnungen mit diesem Wert zugeordnet.If the task isn't already assigned to user with ID 4e98f8f1-bb03-4015-b8e0-19bb370949d8, updating the assignments with this value will assign the task to this user.