Gestion des groupes

Pour télécharger l’exemple de code complet, consultez notre site Code Share .

Parfois, il est pratique de partager des demandes de signatures entre les membres d’un groupe. Par exemple, il peut être pratique de traiter les pharmaciens d’une pharmacie particulière en tant que groupe, afin que tout membre disponible du groupe puisse signer les documents pour les ordonnances d’un patient.

Dans OneSpan Sign, un groupe de signataires est un ensemble d’utilisateurs de OneSpan Sign qui peuvent agir en tant que signataire unique du point de vue du créateur d’une transaction. Les utilisateurs qui peuvent devenir membres d’un groupe doivent déjà être membres du compte OneSpan Sign associé.

Les membres du groupe OneSpan Sign reçoivent une invitation par courriel à signer une transaction. Parmi ces membres, la signature se fait selon le principe du « premier arrivé, premier servi ». Lorsqu’un membre signe, tous les autres membres sont verrouillés.

Tout membre qui signe le fait au nom du groupe, mais son nom sera tamponné sur les documents qu’il signe. Toute personne vérifiant un document par le biais de la piste d’audit verra les informations de signature et l’identité de chaque membre.

Tous les membres du groupe peuvent surveiller la progression des transactions du groupe, ce qui permet de s’assurer que ces transactions sont terminées à temps.

Recherche de vos groupes dans l’interface utilisateur

Tout d’abord, localisez vos groupes dans l’interface utilisateur Web de OneSpan Sign. Pour ce faire, connectez-vous à votre compte OneSpan Sign et cliquez sur Admin > Groupes. Après avoir exécuté votre code, tous vos groupes apparaîtront ici. Si vous ne voyez pas l’option Groupes dans la barre d’outils, c’est peut-être parce qu’ils n’ont pas été activés sur votre compte. Pour les activer, veuillez contacter notre équipe d’assistance.

Pour plus d’informations, consultez Administration des groupes.

Création de groupes

L’exemple de code ci-dessous créera un groupe appelé Java Developers, composé de deux membres. Il est important de noter que ces membres doivent être des expéditeurs de votre compte. La méthode withIndividualMemberEmailing() enverra des e-mails aux membres du groupe au lieu de l’e-mail de groupe spécifié. Si vous souhaitez envoyer des e-mails à l’adresse e-mail du groupe à la place, utilisez withoutIndividualEmailing().

Group group1 = GroupBuilder.newGroup( "Java Developers" )
            .withEmail( "mygroup@aol.com" )
            .withIndividualMemberEmailing()
            .withMember( GroupMemberBuilder.newGroupMember( "manager@mycompany.com" )
                .as( GroupMemberType.REGULAR ) )
            .withMember( GroupMemberBuilder.newGroupMember( "group-member@mycompany.com" )
                    .as( GroupMemberType.REGULAR ) )
                .build();

Une fois que vous avez fait cela, vous pouvez faire appel à votre OneSpan Sign GroupService pour créer votre groupe.

Group createdGroup1 = eslClient.getGroupService().createGroup( group1 );

Vous pouvez également créer un groupe vide et inviter des membres à rejoindre votre groupe à une date ultérieure.

esl.getGroupService().inviteMember( createdEmptyGroup.getId(),
            GroupMemberBuilder.newGroupMember( "member1@example.com" )
                .as( GroupMemberType.REGULAR )
                .build() );

Récupération de groupes

La récupération de vos groupes peut s’avérer utile lorsque vous souhaitez inviter des membres à rejoindre votre groupe. Il est important de noter que l’identifiant du groupe est requis lors de l’envoi d’invitations. La première ligne de l’exemple de code ci-dessous récupérera vos groupes sous forme de liste. Ensuite, pour chaque objet de groupe de la liste, le nom, l’adresse e-mail et l’id du groupe sont récupérés. Avec vos identifiants de groupe, vous pouvez récupérer chaque membre, ainsi que son adresse e-mail, son prénom et son nom.

List<Group> allGroups = esl.getGroupService().getMyGroups();
for ( Group group : allGroups ) {
     System.out.println( group.getName() + " with email " + group.getEmail() + " and id " + group.getId() );
     List<GroupMember> allMembers = esl.getGroupService().getGroupMembers( group.getId() );
     for ( GroupMember member : allMembers ) {
          System.out.println( member.getGroupMemberType().toString() + " " + member.getFirstName() + " " + member.getLastName() + " with email " + member.getEmail());
     }
}

Ajout d’un signataire de groupe

Une fois votre groupe créé, vous pouvez ajouter un signataire de groupe à votre package. Le code ci-dessous vous montre comment modifier le bloc de signataire afin d’ajouter un signataire de groupe.

Si vous avez besoin d’une comparaison avec la création d’un objet document de base, ou si c’est la première fois que vous créez un package avec le SDK Java, consultez cette rubrique.

DocumentPackage myPackage = newPackageNamed( "My Package with Group Signers Java Developers" )
                .withSigner( SignerBuilder.newSignerFromGroup( myGroup.getId() )
                    .canChangeSigner()
                    .deliverSignedDocumentsByEmail() )
                .withDocument( newDocumentWithName( "My Document" )
                    .fromFile("DOCUMENT_FILE_PATH" )
                    .withSignature( signatureFor( myGroup.getId() )
                         .onPage( 0 )
                         .atPosition( 370, 680 ) ) )
                .build();
              
PackageId packageId = esl.createAndSendPackage( myPackage );

Résultats

Après avoir exécuté votre code, vous trouverez vos groupes nouvellement créés dans votre compte OneSpan Sign. Pour voir ces groupes, connectez-vous à votre compte OneSpan Sign et cliquez sur Admin > Groupes. Vous trouverez également votre signature de groupe dans votre liste de destinataires.

Si vous avez utilisé l’exemple de code de cette rubrique pour récupérer vos groupes, voici le résultat :

Pour télécharger l’exemple de code complet, consultez notre site Code Share .

Parfois, il est pratique de partager des demandes de signatures entre les membres d’un groupe. Par exemple, il peut être pratique de traiter les pharmaciens d’une pharmacie particulière en tant que groupe, afin que tout membre disponible du groupe puisse signer les documents pour les ordonnances d’un patient.

Dans OneSpan Sign, un groupe de signataires est un ensemble d’utilisateurs de OneSpan Sign qui peuvent agir en tant que signataire unique du point de vue du créateur d’une transaction. Les utilisateurs qui peuvent devenir membres d’un groupe doivent déjà être membres du compte OneSpan Sign associé.

Les membres du groupe OneSpan Sign reçoivent une invitation par courriel à signer une transaction. Parmi ces membres, la signature se fait selon le principe du « premier arrivé, premier servi ». Lorsqu’un membre signe, tous les autres membres sont verrouillés.

Tout membre qui signe le fait au nom du groupe, mais son nom sera tamponné sur les documents qu’il signe. Toute personne vérifiant un document par le biais de la piste d’audit verra les informations de signature et l’identité de chaque membre.

Tous les membres du groupe peuvent surveiller la progression des transactions du groupe, ce qui permet de s’assurer que ces transactions sont terminées à temps.

Recherche de vos groupes dans l’interface utilisateur

Tout d’abord, localisez vos groupes dans l’interface utilisateur Web de OneSpan Sign. Pour ce faire, connectez-vous à votre compte OneSpan Sign et cliquez sur Admin > Groupes. Après avoir exécuté votre code, tous vos groupes apparaîtront ici. Si vous ne voyez pas l’option Groupes dans la barre d’outils, c’est peut-être parce qu’ils n’ont pas été activés sur votre compte. Pour les activer, veuillez contacter notre équipe d’assistance.

Pour plus d’informations, consultez Administration des groupes.

Création de groupes

L’exemple de code ci-dessous créera un groupe appelé Java Developers, composé de deux membres. Il est important de noter que ces membres doivent être des expéditeurs de votre compte. La méthode withIndividualMemberEmailing() enverra des e-mails aux membres du groupe au lieu de l’e-mail de groupe spécifié. Si vous souhaitez envoyer des e-mails à l’adresse e-mail du groupe à la place, utilisez withoutIndividualEmailing().

Group group1 = GroupBuilder.NewGroup("My Group")
               .WithCustomId(new GroupId(Guid.NewGuid().ToString()))
               .WithMember(GroupMemberBuilder.NewGroupMember("robert.paulson@email.com")
                    .AsMemberType(GroupMemberType.MANAGER))
               .WithMember(GroupMemberBuilder.NewGroupMember("tyler.durden@email.com")
                    .AsMemberType(GroupMemberType.REGULAR))
               .WithEmail("bob@aol.com")
               .WithIndividualMemberEmailing()
               .Build();

Une fois que vous avez fait cela, vous pouvez faire appel à votre OneSpan Sign GroupService pour créer votre groupe.

Group createdGroup1 = eslClient.GroupService.CreateGroup(group1);

Vous pouvez également créer un groupe vide et inviter des membres à rejoindre votre groupe à une date ultérieure.

eslClient.GroupService.InviteMember(createdEmptyGroup.Id, GroupMemberBuilder.NewGroupMember("bob@aol.com")
            .AsMemberType(GroupMemberType.REGULAR)
            .Build());

Récupération de groupes

La récupération de vos groupes peut s’avérer utile lorsque vous souhaitez inviter des membres à rejoindre votre groupe. Il est important de noter que l’identifiant du groupe est requis lors de l’envoi d’invitations. La première ligne de l’exemple de code ci-dessous récupérera vos groupes sous forme de liste. Ensuite, pour chaque objet de groupe de la liste, le nom, l’adresse e-mail et l’id du groupe sont récupérés. Avec vos identifiants de groupe, vous pouvez récupérer chaque membre, ainsi que son adresse e-mail, son prénom et son nom.

List<Group> allGroups = eslClient.GroupService.GetMyGroups();
        foreach (Group group in allGroups)
        {
            Debug.WriteLine(group.Name + " with email " + group.Email + " and id " + group.Id.Id);
            List<GroupMember> allMembers = eslClient.GroupService.GetGroupMembers(group.Id);
            foreach (GroupMember member in allMembers)
            {
                Debug.WriteLine(member.GroupMemberType.ToString() + " " + member.FirstName + " " + member.LastName + " with email " + member.Email);
            }
        }

Ajout d’un signataire de groupe

Une fois votre groupe créé, vous pouvez ajouter un signataire de groupe à votre package. Le code ci-dessous vous montre comment modifier le bloc de signataire afin d’ajouter un signataire de groupe.

DocumentPackage superDuperPackage = PackageBuilder.NewPackageNamed("My Package with Group Signers .NET Developers")
            .WithSigner(SignerBuilder.NewSignerFromGroup(myGroup.Id)
                .CanChangeSigner()
                .DeliverSignedDocumentsByEmail())
            .WithDocument(DocumentBuilder.NewDocumentNamed("My Document")
                .FromFile("DOCUMENT_FILE_PATH")
                .WithSignature(SignatureBuilder.SignatureFor(myGroup.Id)
                  .OnPage(0)
                  .AtPosition(370, 680)))
            .Build();
 
PackageId packageId = eslClient.CreateAndSendPackage(superDuperPackage);

Résultats

Après avoir exécuté votre code, vous trouverez vos groupes nouvellement créés dans votre compte OneSpan Sign. Pour voir ces groupes, connectez-vous à votre compte OneSpan Sign et cliquez sur Admin > Groupes. Vous trouverez également votre signature de groupe dans votre liste de destinataires.

Si vous avez utilisé l’exemple de code de cette rubrique pour récupérer vos groupes, voici le résultat :