Deaktivieren von Benutzern über die API
Erstellt für:
- Entwickler
Wenn ein(e) Benutzende® Ihre Organisation verlässt, können Sie den/die Benutzende(n) deaktivieren, indem Sie dessen/deren Adobe Workfront-Lizenz einem/r anderen Benutzenden zur Verfügung stellen und so verhindern, dass ihm/ihr versehentlich Arbeit zugewiesen wird. Durch die Deaktivierung eines Benutzers behalten Sie seinen Arbeitsverlauf bei, einschließlich der Arbeitszuweisungen und ihrer Zuordnung zu Notizen, Stunden und Dokumenten.
Weitere Informationen zur Deaktivierung von Benutzenden finden Sie unter "Deaktivieren oder Reaktivieren von Benutzenden.
Informationen zur Verwendung der Kern-API finden Sie unter API-Grundlagen.
So deaktivieren Sie einen Benutzer über die API:
- Generieren Sie einen API-Schlüssel mithilfe der folgenden API-Anfrage:
<domain>.my.workfront.com/attask/api/v15.0/user?action=generateApiKey&username=`username`&password=`password`&method=PUT`
-
Suchen Sie die GUID für den Benutzer, den Sie deaktivieren möchten.
- Verwenden Sie die folgende API-Anfrage, um die GUID für alle Benutzer in Ihrem System abzurufen. Beachten Sie, dass das Feld isActive für derzeit aktive Benutzer true und für deaktivierte Benutzer false anzeigt:
<domain>`.my.workfront.com/attask/api/v15.0/USER/search?fields=isActive
- Suchen Sie die GUID für den Benutzer, den Sie deaktivieren möchten, verwenden Sie die folgende PUT-Anfrage, um den Feldwert isActive des Benutzers in "false ändern:
<domain>`.my.workfront.com/attask/api/v15.0/USER/`<user's GUID>`?updates={"isActive":"false"}&method=put&apiKey=`<apiKey>`&fields=isActive
- Die Antwort zeigt an, dass der Wert des isActive-Felds von true in false geändert wurde. Dies bedeutet, dass der Benutzer deaktiviert wurde:
{
data:
{
ID: "592125e60089b88fae8b51c08383e144",
name: "Tyler Reid",
objCode: "USER",
isActive: false
}
}