Création d'une transaction pour un expéditeur

Pour télécharger l'exemple complet de code, consultez notre site Partage de code.

Lors de la création d'une transaction ou d'un modèle, les gestionnaires de compte peuvent désigner manuellement un autre utilisateur de leur compte comme expéditeur. Cet utilisateur sera alors propriétaire de la transaction ou du modèle, et tous les comportements seront les mêmes que si la transaction ou le modèle avait été créé par cet utilisateur.

Le code suivant permet d'effectuer ce qui suit :

DocumentPackage pkg = PackageBuilder.NewPackageNamed("Create on behalf of sender - " + System.DateTime.Now)
        .WithSigner(SignerBuilder.NewSignerWithEmail("[email protected]")
                .WithFirstName("John")
                .WithLastName("Smith"))
        .WithDocument(DocumentBuilder.NewDocumentNamed("document 1")
                .FromFile("your_file_path")
                .WithSignature(SignatureBuilder.SignatureFor("[email protected]")
                        .OnPage(0)
                        .AtPosition(100, 100)
                        .WithSize(250, 75)))
        .WithSenderInfo(SenderInfoBuilder.NewSenderInfo("your_sender_email"))
        .WithVisibility(Visibility.ACCOUNT)              //only works for templates
        .Build();

Notez que vous n'avez pas besoin d'ajouter le nouvel expéditeur en tant que destinataire.

Une fois que vous aurez fait cela, créez la transaction ou le modèle. Le code suivant permet d'effectuer ce qui suit :

PackageId packageId = eslClient.CreatePackageOneStep(pkg);				//package creation
PackageId templateId = eslClient.CreateTemplate(pkg);                                   //template creation

Résultats

Une fois que vous avez créé votre transaction ou votre modèle, notez ce qui suit :

• Dans l'interface Web, la transaction ou le modèle n'apparaîtra que dans le dossier de l'expéditeur désigné. En effet, votre expéditeur est désormais le propriétaire de la transaction ou du modèle.
• Le créateur réel de la transaction ou du modèle ne sera pas ajouté à la transaction ou au modèle en tant que signataire. À la place, le nouvel expéditeur le sera.
• Si vous avez défini la visibilité du compte sur votre modèle, elle apparaîtra dans la liste déroulante Utiliser le modèle.

Pour télécharger l'exemple complet de code, consultez notre site Partage de code.

Lors de la création d'une transaction ou d'un modèle, les gestionnaires de compte peuvent désigner manuellement un autre utilisateur de leur compte comme expéditeur. Cet utilisateur sera alors propriétaire de la transaction ou du modèle, et tous les comportements seront les mêmes que si la transaction ou le modèle avait été créé par cet utilisateur.

La requête suivante vous montre comment construire votre paquet JSON afin d'attribuer un nouvel expéditeur/propriétaire de paquet :

Requête HTTP

POST /api/packages

En-têtes HTTP

Authorization: Basic api_key
Accept: application/json
Content-Type: application/json

Données utiles de la demande

{
  "status": "DRAFT",
  "description": "A test transaction for 'sender on behalf of sender'",
  "language": "en",
  "type": "PACKAGE",
  "name": "Sender On Behalf Of Sender",
  "sender": {
    "email": "your_sender_email"
  }
}

Données utiles de la réponse

{
    "id": "9sKhW-h-qS9m6Ho3zRv3n2a-rkI="
}

Pour créer un modèle au nom de votre expéditeur, utilisez les données utiles suivantes, avec la même API que celle présentée ci-dessus :

{
  "status": "DRAFT",
  "description": "A test transaction for 'sender on behalf of sender'",
  "language": "en",
  "type": "TEMPLATE",
  "visibility":"ACCOUNT",
  "name": "Sender On Behalf Of Sender",
  "sender": {
    "email": "your_sender_email"
  }
}

Dans cet exemple, une transaction ou un modèle minimaliste a été créé. Si vous avez ajouté un nœud Rôles au cours de ce processus, vous n'avez pas besoin d'ajouter explicitement le nouvel expéditeur comme destinataire.

Résultats

Une fois que vous avez créé votre transaction ou votre modèle, notez ce qui suit :

• Dans l'interface Web, la transaction ou le modèle n'apparaîtra que dans le dossier de l'expéditeur désigné. En effet, votre expéditeur est désormais le propriétaire de la transaction ou du modèle.
• Le créateur réel de la transaction ou du modèle ne sera pas ajouté à la transaction ou au modèle en tant que signataire. À la place, le nouvel expéditeur le sera.
• Si vous avez défini la visibilité du compte sur votre modèle, elle apparaîtra dans la liste déroulante Utiliser le modèle.