Mitgliedschaftsabfragen für dynamische Gruppen erstellen

Um Mitgliedschaftsabfragen für dynamische Gruppen in der Admin-Konsole zu erstellen, können Sie die standardmäßigen und/oder benutzerdefinierte Attribute verwenden.

Themen in diesem Hilfeartikel

Standardattribute verwenden

Wenn Sie in der Admin-Konsole eine dynamische Gruppe erstellen, wählen Sie in der Liste „Bedingungen“ die Standardattribute aus. Sie können alle Attribute in der folgenden Tabelle verwenden, um Mitgliedschaftsabfragen für dynamische Gruppen zu erstellen.

Attribut

Beispielcode

Land

addresses.country

user.addresses.exists(address, address.country == 'Canada')

Ländercode

addresses.country_code

user.addresses.exists(address, address.country_code == '555')

Benutzerdefinierter Adresstyp

addresses.custom_type

user.addresses.exists(address, address.custom_type=='Custom address type')

Erweiterte Adresse

addresses.extended_address

user.addresses.exists(address, address.extended_address=='California, USA')

Adresse – Ort

addresses.locality

user.addresses.exists(address, address.locality=='Southern California')

Postleitzahl

addresses.postal_code

user.addresses.exists(address, address.postal_code=='94040')

Postfach

addresses.po_box

user.addresses.exists(address, address.po_box=='87132')

Ist primäre Adresse

addresses.primary

user.addresses.exists(address, address.primary==true)

Region

addresses.region

user.addresses.exists(address, address.region=='Southwest')

Adresse

addresses.street_address

user.addresses.exists(address, address.street_address=='123 Fake St')

Adresstyp

addresses.type

user.addresses.exists(address, address.type==1)

E-Mail-Adresse

emails.address

user.emails.exists(email, email.address.startsWith(''))

Benutzerdefinierter E‑Mail-Typ

emails.custom_type

email.address.startsWith('custom@google.com')

Ist primäre E‑Mail-Adresse

emails.primary

user.emails.exists(email, email.primary==true)

E-Mail-Typ

emails.type

user.emails.exists(email, email.type==1)

Benutzerdefinierter Typ der externen IDs

external_ids.custom_type

user.external_ids.exists(id, id.custom_type.startsWith('runner'))

Typ der externen IDs

external_ids.type

user.external_ids.exists(id, id.type==3)

Externe ID

external_ids.value

user.external_ids.exists(id, id.value=='')

Geschlechtspronomen

gender.address_me_as

user.gender.address_me_as=='they/them'

Benutzerdefinierter Geschlechtstyp

gender.custom_gender

user.gender.custom_gender.startsWith('custom gender')

Geschlechtstyp

gender.type

user.gender.type==3

Benutzerdefiniertes IMS-Protokoll

ims.custom_protocol

user.ims.exists(im, im.custom_protocol.startsWith('custom'))

Benutzerdefinierter IMS-Typ

ims.custom_type

user.ims.exists(im, im.custom_type.startsWith('custom'))

Standard-IMS-Protokoll

ims.standard_protocol

user.ims.exists(im, im.standard_protocol==7)

Ist primäres IMS

ims.primary

user.ims.exists(im, im.primary==true)

IMS-Typ

ims.type

user.ims.exists(im, im.type==3)

Instant Messenger

ims.value

user.ims.exists(im, im.value=='chat')

Benutzerdefinierter Suchbegriffstyp

keywords.custom_type

user.keywords.exists(keyword, keyword.custom_type.startsWith('contractor'))

Keyword-Typ

keywords.type

user.keywords.exists(keyword, keyword.type==3)

Keyword

keywords.value

user.keywords.exists(keyword, keyword.value=='engineer')

Sprachcode

languages.language_code

user.languages.exists(language, language.language_code=='English')

Standortbereich

locations.area

user.locations.exists(loc, loc.area=='Near San Francisco')

Gebäude-ID

locations.building_id

user.locations.exists(loc, loc.building_id=='')

Benutzerdefinierter Positionstyp

locations.custom_type

user.locations.exists(loc, loc.custom_type=='Region')

Schreibtischcode

locations.desk_code

user.locations.exists(loc, loc.desk_code=='Desk 37')

Name des Stockwerks

locations.floor_name

user.locations.exists(loc, loc.floor_name=='')

Bodenbereich

locations.floor_section

user.locations.exists(loc, loc.floor_section=='')

Standorttyp

locations.type

user.locations.exists(loc, loc.type==1)

Last name

name.family_name

user.name.family_name==''

First name

name.given_name

user.name.given_name==''

Name

name.value

user.name.value==''

Kostenstelle

organizations.cost_center

user.organizations.exists(org, org.cost_center=='')

Benutzerdefinierter Organisationstyp

organizations.custom_type

user.organizations.exists(org, org.custom_type=='nonprofit')

Department

organizations.department

user.organizations.exists(org, org.department=='')

Mitarbeitertyp

organizations.description

user.organizations.exists(org, org.description=='search provider')

Domain

organizations.domain

user.organizations.exists(org, org.domain=='example.net')

Standort der Organisation

organizations.location

user.organizations.exists(org, org.location=='California')

Name der Organisation

organizations.name

user.organizations.exists(org, org.name=='Google')

Ist primäre Organisation

organizations.primary

user.organizations.exists(org, org.primary==true)

Symbol der Organisation

organizations.symbol

user.organizations.exists(org, org.symbol=='GOOG')

Position

organizations.title

user.organizations.exists(org, org.title=='')

Art der Organisation

organizations.type

user.organizations.exists(org, org.type==2)

Benutzerdefinierter Telefontyp

phones.custom_type

user.phones.exists(phone, phone.custom_type.startsWith('new type'))

Ist primäre Telefonnummer

phones.primary

user.phones.exists(phone, phone.primary==true)

Telefontyp

phones.type

user.phones.exists(phone, phone.type==11)

Telefonnummer

phones.value

user.phones.exists(phone, phone.value=='')

Benutzerdefinierter Beziehungstyp

relations.custom_type

user.relations.exists(rel, rel.custom_type=='example')

Beziehungswert

relations.value

user.relations.exists(rel, rel.value=='Sundar')

Beziehungstyp

relations.type

user.relations.exists(rel, rel.type==12)

Benutzerdefinierter Websitetyp

websites.custom_type

user.websites.exists(site, site.custom_type.startsWith('creative writing'))

Ist primäre Website

websites.primary

user.websites.exists(site, site.primary==true)

Website-Typ

websites.type

user.websites.exists(site, site.type==2)

Website

websites.value

user.websites.exists(site, site.value=='google.com')

Übergeordnete Organisationseinheit

org_units.org_unit_id

user.org_units.exists(org_unit, org_unit.org_unit_id==orgUnitId(''))

E-Mail-Adresse des Managers

managers.user_id

user.managers.exists(manager, manager.user_id==userId(''))

Ist archiviert

archived

user.archived==true

Passwort bei der Anmeldung ändern

change_password_at_next_login

user.change_password_at_next_login==true

2‑Faktor-Authentifizierung erzwungen

is_2sv_enforced

user.is_2sv_enforced==true

2‑Faktor-Authentifizierung eingerichtet

is_enrolled_in_2sv

user.is_enrolled_in_2sv==true

Mit eingerichtetem Postfach

is_mailbox_setup

user.is_mailbox_setup==true

Primäre E-Mail-Adresse

primary_email

user.primary_email==''

Wurde gesperrt

ausgesetzt

user.suspended==true

Grund der Sperrung

suspension_reason

user.suspension_reason==4

Übergeordnete Organisationseinheit

org_unit_id

user.org_unit_id==orgUnitId('')

Geschlecht

Gender.Gender

user.custom_schemas.Gender.Gender.exists(G, G=='')

Ethnische Zugehörigkeit

Ethnicity.Ethnicity

user.custom_schemas.Ethnicity.Ethnicity.exists(E, E=='')

Benutzerdefinierte Attribute verwenden

Wenn Sie eine Mitgliedschaftsabfrage in der Admin-Konsole erstellen, werden benutzerdefinierte Attribute nach Standardattributen in der Liste „Bedingung“ angezeigt.

Wenn Sie eine Abfrage ausführen, die ein benutzerdefiniertes Attribut enthält, und die Abfrage keine Mitglieder zurückgibt, sind die Attributeigenschaften in der Groups API möglicherweise falsch festgelegt. Insbesondere das Attribut „indexed“ muss auf „true“ gesetzt sein. Weitere Informationen finden Sie unter Benutzerdefinierte Nutzerattribute.

Nutzer automatisch in dynamische Gruppe aufnehmen

Sie können die Kontoinformationen eines Nutzers so bearbeiten, dass sie den Abfragebedingungen entsprechen und der Nutzer automatisch in eine dynamische Gruppe aufgenommen wird. Sie bearbeiten die Kontodetails eines Nutzers mit der Directory API. Weitere Informationen finden Sie im Hilfeartikel Nutzerkonten aktualisieren.

In der Admin-Konsole können Sie auch einige Details von Nutzerkonten bearbeiten, in der Regel auf der Seite „Nutzer“. Dazu gehören:

2‑Faktor-Authentifizierung erzwungen 2-Faktor-Authentifizierung aktiviert
Adresstyp Ursprüngliche Organisationseinheit
Gebäude-ID Passwort bei der Anmeldung ändern
Kostenstelle Abteilung
E-Mail-Adresse E-Mail-Typ
Externe ID Vorname
Etage Etagenabschnitt
Ist archiviert Ist primäre E‑Mail-Adresse
Mit eingerichtetem Postfach Der Partner wurde gesperrt.
Position Nachname
Manager-Nutzer-ID Name
Übergeordnete Organisationseinheit Telefonnummer
Telefontyp

Nutzer aus dynamischer Gruppe ausschließen

Wenn Sie nur Nutzer hinzufügen möchten, die eine Bedingung nicht erfüllen, erstellen Sie eine Bedingung für die dynamische Gruppe und klicken Sie dann auf „Ausschließen“ . Wenn Sie beispielsweise eine Gruppe erstellen möchten, die nur Nutzer enthält, die nicht in den USA leben, erstellen Sie die Bedingung „Ländercode ist gleich US“ und klicken Sie dann auf „Ausschließen“ . In der Abfrage wird ein Ausrufezeichen (!) für den Ausschluss angezeigt.

Bei einigen benutzerdefinierten Abfragen mit dem Parameter „exists“ können Sie die Ausschlussoption nicht verwenden. Weitere Informationen finden Sie unter Abfragen formulieren und testen.