Documentation ¶
Overview ¶
Package forms implements the DocuSign SDK category Forms.
## Form groups
With the appropriate permissions, form administrators at your company can create form groups, or curated set of forms gathered from the association **form libraries** to which DocuSign provides access. Form groups enable agents to know which forms to add to rooms based on the type of transaction they are working on. When creating groups, administrators can make certain forms required, ensuring compliance. If you don't create groups, agents will have to choose forms they need from a list of association forms.
## Permissions
To manage forms, you must have the `canManageFormGroups` permission, which enables you to access the **Forms** tab in **Admin**. For all other roles, assign permissions based on how these users will be working with forms. If no form permissions are enabled for these roles, users cannot add forms to rooms.
Form administrators must have the `canManageFormGroups` permission assigned to their user role. This gives them access to the **Forms** tab in **Admin**. However, you should also consider the user's access level. For example, if the user has access to specific offices, they can only administer form groups for those offices.
Service Api documentation may be found at: https://developers.docusign.com/docs/rooms-api/reference/Forms Usage example:
import ( "github.com/jfcote87/esign" "github.com/jfcote87/esign/rooms" ) ... formsService := forms.New(esignCredential)
Index ¶
- type AssignFormGroupFormOp
- type CreateExternalFormFillSessionOp
- type CreateFormGroupOp
- type DeleteFormGroupOp
- type GetFormDetailsOp
- type GetFormGroupOp
- type GetFormGroupsOp
- type GetFormLibrariesOp
- type GetFormLibraryFormsOp
- type GrantOfficeAccessToFormGroupOp
- type RemoveFormGroupFormOp
- type RenameFormGroupOp
- type RevokeOfficeAccessFromFormGroupOp
- type Service
- func (s *Service) AssignFormGroupForm(formGroupID string, body *rooms.FormGroupFormToAssign) *AssignFormGroupFormOp
- func (s *Service) CreateExternalFormFillSession(body *rooms.ExternalFormFillSessionForCreate) *CreateExternalFormFillSessionOp
- func (s *Service) CreateFormGroup(body *rooms.FormGroupForCreate) *CreateFormGroupOp
- func (s *Service) DeleteFormGroup(formGroupID string) *DeleteFormGroupOp
- func (s *Service) GetFormDetails(formID string) *GetFormDetailsOp
- func (s *Service) GetFormGroup(formGroupID string) *GetFormGroupOp
- func (s *Service) GetFormGroups() *GetFormGroupsOp
- func (s *Service) GetFormLibraries() *GetFormLibrariesOp
- func (s *Service) GetFormLibraryForms(formLibraryID string) *GetFormLibraryFormsOp
- func (s *Service) GrantOfficeAccessToFormGroup(formGroupID string, officeID string, media io.Reader, mimeType string) *GrantOfficeAccessToFormGroupOp
- func (s *Service) RemoveFormGroupForm(formGroupID string, formID string, media io.Reader, mimeType string) *RemoveFormGroupFormOp
- func (s *Service) RenameFormGroup(formGroupID string, body *rooms.FormGroupForUpdate) *RenameFormGroupOp
- func (s *Service) RevokeOfficeAccessFromFormGroup(formGroupID string, officeID string, media io.Reader, mimeType string) *RevokeOfficeAccessFromFormGroupOp
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type AssignFormGroupFormOp ¶
AssignFormGroupFormOp implements DocuSign API SDK Forms::AssignFormGroupForm
type CreateExternalFormFillSessionOp ¶
CreateExternalFormFillSessionOp implements DocuSign API SDK Forms::CreateExternalFormFillSession
func (*CreateExternalFormFillSessionOp) Do ¶
func (op *CreateExternalFormFillSessionOp) Do(ctx context.Context) (*rooms.ExternalFormFillSession, error)
Do executes the op. A nil context will return error.
type CreateFormGroupOp ¶
CreateFormGroupOp implements DocuSign API SDK Forms::CreateFormGroup
type DeleteFormGroupOp ¶
DeleteFormGroupOp implements DocuSign API SDK Forms::DeleteFormGroup
type GetFormDetailsOp ¶
GetFormDetailsOp implements DocuSign API SDK Forms::GetFormDetails
func (*GetFormDetailsOp) Do ¶
func (op *GetFormDetailsOp) Do(ctx context.Context) (*rooms.FormDetails, error)
Do executes the op. A nil context will return error.
type GetFormGroupOp ¶
GetFormGroupOp implements DocuSign API SDK Forms::GetFormGroup
type GetFormGroupsOp ¶
GetFormGroupsOp implements DocuSign API SDK Forms::GetFormGroups
func (*GetFormGroupsOp) Count ¶
func (op *GetFormGroupsOp) Count(val int) *GetFormGroupsOp
Count (Optional) The number of results to return. This value must be a number between `1` and `100` (default).
func (*GetFormGroupsOp) Do ¶
func (op *GetFormGroupsOp) Do(ctx context.Context) (*rooms.FormGroupSummaryList, error)
Do executes the op. A nil context will return error.
func (*GetFormGroupsOp) StartPosition ¶
func (op *GetFormGroupsOp) StartPosition(val int) *GetFormGroupsOp
StartPosition (Optional) The starting zero-based index position of the results set. The default value is `0`.
type GetFormLibrariesOp ¶
GetFormLibrariesOp implements DocuSign API SDK Forms::GetFormLibraries
func (*GetFormLibrariesOp) Count ¶
func (op *GetFormLibrariesOp) Count(val int) *GetFormLibrariesOp
Count (Optional) The number of results to return. This value must be a number between `1` and `100` (default).
func (*GetFormLibrariesOp) Do ¶
func (op *GetFormLibrariesOp) Do(ctx context.Context) (*rooms.FormLibrarySummaryList, error)
Do executes the op. A nil context will return error.
func (*GetFormLibrariesOp) StartPosition ¶
func (op *GetFormLibrariesOp) StartPosition(val int) *GetFormLibrariesOp
StartPosition (Optional) The starting zero-based index position of the results set. The default value is `0`.
type GetFormLibraryFormsOp ¶
GetFormLibraryFormsOp implements DocuSign API SDK Forms::GetFormLibraryForms
func (*GetFormLibraryFormsOp) Count ¶
func (op *GetFormLibraryFormsOp) Count(val int) *GetFormLibraryFormsOp
Count (Optional) The number of results to return. This value must be a number between `1` and `100` (default).
func (*GetFormLibraryFormsOp) Do ¶
func (op *GetFormLibraryFormsOp) Do(ctx context.Context) (*rooms.FormSummaryList, error)
Do executes the op. A nil context will return error.
func (*GetFormLibraryFormsOp) StartPosition ¶
func (op *GetFormLibraryFormsOp) StartPosition(val int) *GetFormLibraryFormsOp
StartPosition (Optional) The starting zero-based index position of the results set. The default value is `0`.
type GrantOfficeAccessToFormGroupOp ¶
GrantOfficeAccessToFormGroupOp implements DocuSign API SDK Forms::GrantOfficeAccessToFormGroup
type RemoveFormGroupFormOp ¶
RemoveFormGroupFormOp implements DocuSign API SDK Forms::RemoveFormGroupForm
type RenameFormGroupOp ¶
RenameFormGroupOp implements DocuSign API SDK Forms::RenameFormGroup
type RevokeOfficeAccessFromFormGroupOp ¶
RevokeOfficeAccessFromFormGroupOp implements DocuSign API SDK Forms::RevokeOfficeAccessFromFormGroup
type Service ¶
type Service struct {
// contains filtered or unexported fields
}
Service implements DocuSign Forms API operations
func New ¶
func New(cred esign.Credential) *Service
New initializes a forms service using cred to authorize ops.
func (*Service) AssignFormGroupForm ¶
func (s *Service) AssignFormGroupForm(formGroupID string, body *rooms.FormGroupFormToAssign) *AssignFormGroupFormOp
AssignFormGroupForm assigns a form to a form group.
https://developers.docusign.com/docs/rooms-api/reference/forms/formgroups/assignformgroupform
SDK Method Forms::AssignFormGroupForm
func (*Service) CreateExternalFormFillSession ¶
func (s *Service) CreateExternalFormFillSession(body *rooms.ExternalFormFillSessionForCreate) *CreateExternalFormFillSessionOp
CreateExternalFormFillSession creates an external form fill session.
SDK Method Forms::CreateExternalFormFillSession
func (*Service) CreateFormGroup ¶
func (s *Service) CreateFormGroup(body *rooms.FormGroupForCreate) *CreateFormGroupOp
CreateFormGroup creates a form group.
https://developers.docusign.com/docs/rooms-api/reference/forms/formgroups/createformgroup
SDK Method Forms::CreateFormGroup
func (*Service) DeleteFormGroup ¶
func (s *Service) DeleteFormGroup(formGroupID string) *DeleteFormGroupOp
DeleteFormGroup deletes a form group.
https://developers.docusign.com/docs/rooms-api/reference/forms/formgroups/deleteformgroup
SDK Method Forms::DeleteFormGroup
func (*Service) GetFormDetails ¶
func (s *Service) GetFormDetails(formID string) *GetFormDetailsOp
GetFormDetails gets form details.
https://developers.docusign.com/docs/rooms-api/reference/forms/formdetails/getformdetails
SDK Method Forms::GetFormDetails
func (*Service) GetFormGroup ¶
func (s *Service) GetFormGroup(formGroupID string) *GetFormGroupOp
GetFormGroup gets a form group.
https://developers.docusign.com/docs/rooms-api/reference/forms/formgroups/getformgroup
SDK Method Forms::GetFormGroup
func (*Service) GetFormGroups ¶
func (s *Service) GetFormGroups() *GetFormGroupsOp
GetFormGroups gets form groups.
https://developers.docusign.com/docs/rooms-api/reference/forms/formgroups/getformgroups
SDK Method Forms::GetFormGroups
func (*Service) GetFormLibraries ¶
func (s *Service) GetFormLibraries() *GetFormLibrariesOp
GetFormLibraries gets form libraries.
https://developers.docusign.com/docs/rooms-api/reference/forms/formlibraries/getformlibraries
SDK Method Forms::GetFormLibraries
func (*Service) GetFormLibraryForms ¶
func (s *Service) GetFormLibraryForms(formLibraryID string) *GetFormLibraryFormsOp
GetFormLibraryForms gets the forms in a form library.
https://developers.docusign.com/docs/rooms-api/reference/forms/formlibraries/getformlibraryforms
SDK Method Forms::GetFormLibraryForms
func (*Service) GrantOfficeAccessToFormGroup ¶
func (s *Service) GrantOfficeAccessToFormGroup(formGroupID string, officeID string, media io.Reader, mimeType string) *GrantOfficeAccessToFormGroupOp
GrantOfficeAccessToFormGroup grants an office access to a form group. If media is an io.ReadCloser, Do() will close media.
SDK Method Forms::GrantOfficeAccessToFormGroup
func (*Service) RemoveFormGroupForm ¶
func (s *Service) RemoveFormGroupForm(formGroupID string, formID string, media io.Reader, mimeType string) *RemoveFormGroupFormOp
RemoveFormGroupForm removes a form from a form group. If media is an io.ReadCloser, Do() will close media.
https://developers.docusign.com/docs/rooms-api/reference/forms/formgroups/removeformgroupform
SDK Method Forms::RemoveFormGroupForm
func (*Service) RenameFormGroup ¶
func (s *Service) RenameFormGroup(formGroupID string, body *rooms.FormGroupForUpdate) *RenameFormGroupOp
RenameFormGroup renames a form group.
https://developers.docusign.com/docs/rooms-api/reference/forms/formgroups/renameformgroup
SDK Method Forms::RenameFormGroup
func (*Service) RevokeOfficeAccessFromFormGroup ¶
func (s *Service) RevokeOfficeAccessFromFormGroup(formGroupID string, officeID string, media io.Reader, mimeType string) *RevokeOfficeAccessFromFormGroupOp
RevokeOfficeAccessFromFormGroup revoke an office's access to a form group. If media is an io.ReadCloser, Do() will close media.
SDK Method Forms::RevokeOfficeAccessFromFormGroup