Delegated Administration : Memberships Query Hook

Découvrez comment utiliser le Memberships Query Hook avec la Delegated Administration Extension.

Lors de la création d’un nouvel utilisateur, l’interface utilisateur affiche une liste déroulante dans laquelle vous pouvez choisir la ou les appartenances à attribuer à l’utilisateur. Ces appartenances sont ensuite définies à l’aide du Memberships Query Hook.

​

Contrat du Hook

• ctx : Objet de contexte.
• callback(error, { createMemberships: true/false, memberships: }) : Callback dans lequel vous pouvez retourner une erreur et un objet contenant la configuration des appartenances.

​

Exemple d’utilisation

Les utilisateurs du département informatique devraient pouvoir créer des utilisateurs dans d’autres départements. Les utilisateurs des autres départements devraient seulement pouvoir créer des utilisateurs pour leur propre département.

function(ctx, callback) {
  var currentDepartment = ctx.payload.user.app_metadata && ctx.payload.user.app_metadata.department;
  if (!currentDepartment || !currentDepartment.length) {
    return callback(null, [ ]);
  }

  if (currentDepartment === 'IT') {
    return callback(null, [ 'IT', 'HR', 'Finance', 'Marketing' ]);
  }

  return callback(null, [ ctx.payload.user.app_metadata.department ]);
}

​

Remarques

Comme vous ne pouvez utiliser cette query que dans l’UI, vous devrez attribuer les appartenances à l’aide du Write Hook si vous devez faire respecter des règles concernant l’attribution des utilisateurs à des départements précis.

S’il n’existe qu’un seul groupe d’appartenance possible, le champ Appartenances ne s’affichera pas dans l’UI.

Vous pouvez permettre à l’utilisateur final de saisir n’importe quelle valeur dans le champ memberships en définissant createMemberships à true :

function(ctx, callback) {
  var currentDepartment = ctx.payload.user.app_metadata.department;
  if (!currentDepartment || !currentDepartment.length) {
    return callback(null, [ ]);
  }

  return callback(null, {
    createMemberships: ctx.payload.user.app_metadata.department === 'IT' ? true : false,
    memberships: [ ctx.payload.user.app_metadata.department ]
  });
}

​

Pour en savoir plus

• Delegated Administration : Access Hook
• Delegated Administration : Filter Hook
• Delegated Administration : Settings Query Hook
• Delegated Administration : Write Hook