Définition de l'objet
Flux
Flow
Les propriétés d'une fiche « Flux », ses énumérations et ses liaisons avec les autres fiches.
Une fiche « Flux », telle que l'API la lit et l'écrit (Flow dans la référence). Sa liste et sa création : https://staging-api.docage.com/Flows ; une fiche : https://staging-api.docage.com/Flows/{id}. Les propriétés communes à toutes les fiches sont sur la page des définitions des objets.
Ses propriétés
ConcurrencyModeFlowConcurrencyModeMode de concurrence
CreditsSpentnombreÉcrite par le serveurCrédits dépensés
DepthentierÉcrite par le serveurProfondeur
DescriptiontexteDescription
EndedOndate et heure (UTC)Écrite par le serveurFin
EntryFlowNodeIdidentifiantÉcrite par le serveurIdentifiant du nœud d'entrée
ErrorBranchFinalStatusFlowErrorBranchFinalStatusLe statut final d'une exécution dont une étape a échoué et a suivi sa branche d'erreur. Lu par
FlowExecutor.ConcludeIfFinished; recopié du modèle dans chaque exécution comme les autres réglages.ErrorMessagetexteÉcrite par le serveurMessage d'erreur
ErrorPolicyFlowErrorPolicyPolitique d'erreur
Le régime de cette exécution, et non celui du modèle, qui peut porter les deux : une exécution interne (Internal) ne suit que les liens internes, une exécution différée (Deferred) que les autres ; une exécution ne mélange jamais les deux. Un flux dont le départ porte les deux sortes de branches produit donc deux exécutions : l'une jouée pendant l'enregistrement de la fiche, l'autre ensuite, par la file d'attente des exécutions. Une exécution interne est déjà terminée quand elle est enregistrée.
FlowCanvasFlowCanvasÉcrite par le serveurCanevas
FlowLinksliste deFlowLinkÉcrite par le serveurLiens
FlowNodesliste deFlowNodeÉcrite par le serveurNœuds
FlowVariablesliste deFlowVariableÉcrite par le serveurVariables
IsEnabledoui ou nonÉcrite par le serveurActif
IsPreviewoui ou nonÉcrite par le serveurPrévisualisation
LastNodeNumberentierÉcrite par le serveurDernier numéro d'étape
LeasedBytexteÉcrite par le serveurBail détenu par
LeasedUntildate et heure (UTC)Écrite par le serveurBail jusqu'à
MaxCreditsPerDayentierCrédits maximum par jour
MaxRunsPerTargetPerDayentierExécutions maximum par entité et par jour
MergeEntitiesliste deMergeEntityEntités de fusion
OwnerDocageUserIdidentifiantÉcrite par le serveurIdentifiant du propriétaire
ResumeAfterdate et heure (UTC)Écrite par le serveurReprise après
RunAsDocageUserIdidentifiantÉcrite par le serveurIdentifiant de l'identité d'exécution
RunAsModeFlowRunAsModeL'identité sous laquelle le flux agit : l'utilisateur à l'origine du déclenchement s'il y en a un, sinon le propriétaire du modèle (FlowRunAsMode.Executant, par défaut), ou toujours le propriétaire du modèle (FlowRunAsMode.TemplateOwner) — qui ne peut être que le créateur du modèle ou l'auteur du formulaire dont il est issu, jamais un compte désigné à la main (
OwnerDocageUserId). Choisie par le créateur du flux ; ensuite, seul un utilisateur qui a le droit d'administrer le flux peut la changer : le droit de le modifier ne suffit pas.RunRetentionDaysentierRétention des exécutions (jours)
StartedOndate et heure (UTC)Écrite par le serveurDébut
État
TargetEntityIdidentifiantÉcrite par le serveurIdentifiant de l'entité cible
TargetEntityTypeNametexteÉcrite par le serveurNom du type d'entité cible
TriggeredByFlowIdidentifiantÉcrite par le serveurIdentifiant du flux déclencheur
TriggeredByFlowTriggerIdidentifiantÉcrite par le serveurIdentifiant du déclencheur
AddToBoxIdsliste d'identifiantsIdentifiants des classeurs à lier à l'entité
ArchiveRetentionYearsentierDurée d'archivage en années
BoxIdsliste d'identifiantsLecture seuleIdentifiants des classeurs liés à l'entité (lecture seule)
CreationDatedate et heure (UTC)Écrite par le serveurDate de création
Créateur
CreationUserIdidentifiantÉcrite par le serveurIdentifiant du créateur
CultureInfotexteCulture
CustomFieldsliste deFieldLes champs personnalisés de la fiche : ceux de son organisation et ceux de son modèle.
CustomFieldsForInstancesliste deFieldChamps personnalisés pour les entités générées par le modèle
CustomFieldsFromOrganizationliste deFieldChamps personnalisés de l'organisation
CustomFieldsFromTemplateliste deFieldChamps personnalisés du modèle
CustomFieldsUserDataliste deFieldUserDataValeurs des champs personnalisés
DeletionDatedate et heure (UTC)Écrite par le serveurDate de suppression
Auteur de la suppression
DeletionUserIdidentifiantÉcrite par le serveurIdentifiant de l'auteur de la suppression
DynamicInclusionDynamicInclusionSi une inclusion dynamique est définie, l'entité sera incluse dans son parent que si la condition est remplie
EntityStateStateLevelLecture seuleEtat de l'entité
ExternalIdtexte, 128 caractères au plusIdentifiant externe
GeneratedByCampaignIdidentifiantÉcrite par le serveurCampagne ayant généré l'entité
GeneratedByFormIdidentifiantIdentifiant du formulaire ayant généré l'entité
IdidentifiantÉcrite par le serveurIdentifiant
IsArchivedoui ou nonArchivé
IsSystemoui ou nonÉcrite par le serveurEst système
IsTemplateoui ou nonLecture seuleEst un modèle
LanguageLanguageLangue
LastModificationDatedate et heure (UTC)Écrite par le serveurDate de modification
Dernier modificateur
LastModificationUserIdidentifiantÉcrite par le serveurIdentifiant du dernier modificateur
MergeEntitiesliste deMergeEntityObjets participant à la fusion
MergeFieldsliste deMergeFieldChamps de fusion
MustBeArchivedoui ou nonDate de début d'archivage
Nametexte, 255 caractères au plusNom
NotestexteNotes
ParentOrganizationIdidentifiantLecture seuleOrganisation parente
ParentRightsDTOliste deRightDTOLes nouveaux droits de la fiche, à sa création ou à sa mise à jour : la liste REMPLACE ses droits, elle doit donc contenir tous les nouveaux droits. Réservé à qui administre la fiche : pouvoir la modifier ne suffit pas.
RelationDefinitionsForInstancesliste deRelationDefinitionLes relations déclarées sur ce modèle : une extrémité est imposée (le modèle lui-même), et la relation ne vaut que pour ses instances — en plus de celles déclarées au niveau de l'organisation dont une extrémité est du même type. Elles se propagent comme CustomFieldsForInstances : une instance les lit dans RelationDefinitionsFromTemplate.
RelationDefinitionsFromTemplateliste deRelationDefinitionLes relations qu'une instance tient de son modèle. Elles ne sont pas recopiées : elles se relisent sur le modèle à chaque lecture. Ajouter une relation sur un modèle la fait donc apparaître sur toutes ses instances existantes, y compris celles créées avant, comme un champ personnalisé (CustomFieldsFromTemplate).
RemoveFromBoxIdsliste d'identifiantsIdentifiants des classeurs à délier de l'entité
TemplateIdidentifiantIdentifiant de Modèle utilisé
Aucune propriété ne correspond.
Ses énumérations
FlowConcurrencyMode
- 0Parallèle
- 1Une seule active par entité
- 2Mise en file
FlowErrorBranchFinalStatus
- 0En échec
- 1Réussi
FlowErrorPolicy
- 0Arrêter le flux
- 1Continuer
- 2Suivre la branche d'erreur
FlowExecutionMode
- 0Enregistrement
- 1Saisie
FlowRunAsMode
- 0Exécutant
- 1Créateur du modèle
FlowStatus
- 0En attente
- 1En cours
- 2En attente d'un délai
- 3En attente d'approbation
- 7En attente d'un flux appelé
- 4Réussi
- 5En échec
- 6Annulé
Ses liaisons
Les fiches auxquelles elle se lie, et le rôle de chacune : ce que LinkedToTypeName et LinkedToId retrouvent dans
une liste (voir Lire des listes).