Update python SDK docs: 17132312980

This commit is contained in:
developer-relations-sp
2025-08-21 16:01:51 +00:00
parent 6529e8916a
commit ed086d4f22
36 changed files with 510 additions and 581 deletions

View File

@@ -16,21 +16,21 @@ tags: ['SDK', 'Software Development Kit', 'FormInstanceResponse', 'V2025FormInst
Name | Type | Description | Notes
------------ | ------------- | ------------- | -------------
**created** | **datetime** | Created is the date the form instance was assigned | [optional]
**created_by** | [**FormInstanceCreatedBy**](form-instance-created-by) | | [optional]
**expire** | **str** | Expire is the maximum amount of time that a form can be in progress. After this time is reached then the form will be moved to a CANCELED state automatically. The user will no longer be able to complete the submission. When a form instance is expires an audit log will be generated for that record | [optional]
**form_conditions** | [**[]FormCondition**](form-condition) | FormConditions is the conditional logic that modify the form dynamically modify the form as the recipient is interacting out the form | [optional]
**form_data** | **map[string]object** | FormData is the data provided by the form on submit. The data is in a key -> value map | [optional]
**form_definition_id** | **str** | FormDefinitionID is the id of the form definition that created this form | [optional]
**form_elements** | [**[]FormElement**](form-element) | FormElements is the configuration of the form, this would be a repeat of the fields from the form-config | [optional]
**form_errors** | [**[]FormError**](form-error) | FormErrors is an array of form validation errors from the last time the form instance was transitioned to the SUBMITTED state. If the form instance had validation errors then it would be moved to the IN PROGRESS state where the client can retrieve these errors | [optional]
**form_input** | **map[string]object** | FormInput is an object of form input labels to value | [optional]
**id** | **str** | Unique guid identifying this form instance | [optional]
**modified** | **datetime** | Modified is the last date the form instance was modified | [optional]
**recipients** | [**[]FormInstanceRecipient**](form-instance-recipient) | Recipients references to the recipient of a form. The recipients are those who are responsible for filling out a form and completing it | [optional]
**expire** | **str** | Expire is the maximum amount of time that a form can be in progress. After this time is reached then the form will be moved to a CANCELED state automatically. The user will no longer be able to complete the submission. When a form instance is expires an audit log will be generated for that record | [optional]
**state** | **Enum** [ 'ASSIGNED', 'IN_PROGRESS', 'SUBMITTED', 'COMPLETED', 'CANCELLED' ] | State the state of the form instance ASSIGNED FormInstanceStateAssigned IN_PROGRESS FormInstanceStateInProgress SUBMITTED FormInstanceStateSubmitted COMPLETED FormInstanceStateCompleted CANCELLED FormInstanceStateCancelled | [optional]
**stand_alone_form** | **bool** | StandAloneForm is a boolean flag to indicate if this form should be available for users to complete via the standalone form UI or should this only be available to be completed by as an embedded form | [optional] [default to False]
**stand_alone_form_url** | **str** | StandAloneFormURL is the URL where this form may be completed by the designated recipients using the standalone form UI | [optional]
**state** | **Enum** [ 'ASSIGNED', 'IN_PROGRESS', 'SUBMITTED', 'COMPLETED', 'CANCELLED' ] | State the state of the form instance ASSIGNED FormInstanceStateAssigned IN_PROGRESS FormInstanceStateInProgress SUBMITTED FormInstanceStateSubmitted COMPLETED FormInstanceStateCompleted CANCELLED FormInstanceStateCancelled | [optional]
**created_by** | [**FormInstanceCreatedBy**](form-instance-created-by) | | [optional]
**form_definition_id** | **str** | FormDefinitionID is the id of the form definition that created this form | [optional]
**form_input** | **map[string]object** | FormInput is an object of form input labels to value | [optional]
**form_elements** | [**[]FormElement**](form-element) | FormElements is the configuration of the form, this would be a repeat of the fields from the form-config | [optional]
**form_data** | **map[string]object** | FormData is the data provided by the form on submit. The data is in a key -> value map | [optional]
**form_errors** | [**[]FormError**](form-error) | FormErrors is an array of form validation errors from the last time the form instance was transitioned to the SUBMITTED state. If the form instance had validation errors then it would be moved to the IN PROGRESS state where the client can retrieve these errors | [optional]
**form_conditions** | [**[]FormCondition**](form-condition) | FormConditions is the conditional logic that modify the form dynamically modify the form as the recipient is interacting out the form | [optional]
**created** | **datetime** | Created is the date the form instance was assigned | [optional]
**modified** | **datetime** | Modified is the last date the form instance was modified | [optional]
**recipients** | [**[]FormInstanceRecipient**](form-instance-recipient) | Recipients references to the recipient of a form. The recipients are those who are responsible for filling out a form and completing it | [optional]
}
## Example
@@ -39,11 +39,39 @@ Name | Type | Description | Notes
from sailpoint.v2025.models.form_instance_response import FormInstanceResponse
form_instance_response = FormInstanceResponse(
created='2023-07-12T20:14:57.744860Z',
id='06a2d961-07fa-44d1-8d0a-2f6470e30fd2',
expire='2023-08-12T20:14:57.74486Z',
state='ASSIGNED',
stand_alone_form=False,
stand_alone_form_url='https://my-org.identitynow.com/ui/d/forms/00000000-0000-0000-0000-000000000000',
created_by=sailpoint.v2025.models.form_instance_created_by.FormInstanceCreatedBy(
id = '00000000-0000-0000-0000-000000000000',
type = 'WORKFLOW_EXECUTION', ),
expire='2023-08-12T20:14:57.74486Z',
form_definition_id='49841cb8-00a5-4fbd-9888-8bbb28d48331',
form_input={input1=Sales},
form_elements=[
sailpoint.v2025.models.form_element.FormElement(
id = '00000000-0000-0000-0000-000000000000',
element_type = 'TEXT',
config = {label=Department},
key = 'department',
validations = [
sailpoint.v2025.models.form_element_validations_set.FormElementValidationsSet(
validation_type = 'REQUIRED', )
], )
],
form_data={department=Engineering},
form_errors=[
sailpoint.v2025.models.form_error.FormError(
key = 'department',
messages = [
sailpoint.v2025.models.error_message_is_the_standard_api_error_response_message_type/.ErrorMessage is the standard API error response message type.(
locale = 'en-US',
locale_origin = 'DEFAULT',
text = 'This is an error', )
],
value = Engineering, )
],
form_conditions=[
sailpoint.v2025.models.form_condition.FormCondition(
rule_operator = 'AND',
@@ -63,41 +91,13 @@ form_conditions=[
element = '8110662963316867', ), )
], )
],
form_data={department=Engineering},
form_definition_id='49841cb8-00a5-4fbd-9888-8bbb28d48331',
form_elements=[
sailpoint.v2025.models.form_element.FormElement(
id = '00000000-0000-0000-0000-000000000000',
element_type = 'TEXT',
config = {label=Department},
key = 'department',
validations = [
sailpoint.v2025.models.form_element_validations_set.FormElementValidationsSet(
validation_type = 'REQUIRED', )
], )
],
form_errors=[
sailpoint.v2025.models.form_error.FormError(
key = 'department',
messages = [
sailpoint.v2025.models.error_message_is_the_standard_api_error_response_message_type/.ErrorMessage is the standard API error response message type.(
locale = 'en-US',
locale_origin = 'DEFAULT',
text = 'This is an error', )
],
value = Engineering, )
],
form_input={input1=Sales},
id='06a2d961-07fa-44d1-8d0a-2f6470e30fd2',
created='2023-07-12T20:14:57.744860Z',
modified='2023-07-12T20:14:57.744860Z',
recipients=[
sailpoint.v2025.models.form_instance_recipient.FormInstanceRecipient(
id = '00000000-0000-0000-0000-000000000000',
type = 'IDENTITY', )
],
stand_alone_form=False,
stand_alone_form_url='https://my-org.identitynow.com/ui/d/forms/00000000-0000-0000-0000-000000000000',
state='ASSIGNED'
]
)
```