Initialisation du flux uip maestro

Syntaxe et options pour `uip maestro flow init`, qui élaborationt un nouveau projet Flow avec un manifeste et un fichier de démarrage `.flow` minimaux.

uip maestro flow init élabore un nouveau répertoire de projet Flow avec un manifeste minimal et un fichier .flow de démarrage contenant un seul nœud de déclencheur manuel.

Synthèse

uip maestro flow init <name> [--force] [--skip-solution-registration]

Les options globales sont respectées. Les codes de sortie suivent le contrat standard.

Arguments

• <name> (obligatoire) : nom du dossier du projet. Validé par rapport à VALID_PROJECT_NAME_REGEX: lettres, chiffres, traits de soulignement (_) et traits d’union (-) uniquement.

Options

• --force — initialise même si le répertoire cible existe et n'est pas vide. Les fichiers existants ne sont pas effacés - les fichiers sont écrits avec; Cela est utile pour la réinitialisation dans un dossier pré-créé.
• --skip-solution-registration — do not auto-register this project in the surrounding solution (see Behavior below).

Comportement

The command writes two files into <name>/:

• project.uiproj — { "Name": "<name>", "ProjectType": "Flow" }
• <name>.flow — référencer le flux JSON contenant:
  • Un core.trigger.manual nœud de démarrage connecté à un entryPointIdgénéré
  • La définition du nœud correspondant dans definitions[]
  • Vide edges, bindings, variables
  • Position layout.nodes.start de la zone de dessin

Solution auto-registration. Unless --skip-solution-registration is passed:

• If the current directory is already inside a solution, <name>/ is created there and registered as a project in that solution's .uipx manifest.
• If the current directory is not inside a solution, a parent solution named <name>Solution is scaffolded automatically — the Flow project ends up nested at <name>Solution/<name>/, not at <name>/ in the current directory as a literal reading of the synopsis might suggest.

Si <name> existe déjà et n’est pas vide et que --force n’est pas défini, la commande échoue en présentant une erreur invitant l’utilisateur à transmettre --force

Exemples

# Create a new project in ./invoice-flow
uip maestro flow init invoice-flow

# Reinitialize into an existing non-empty folder (e.g. a Git repo)
uip maestro flow init invoice-flow --force

Format des données (--sortie json)

{
  "Code": "FlowInit",
  "Data": {
    "Status": "Created successfully",
    "Path": "/workspace/my-flow-projectSolution/my-flow-project",
    "SolutionRegistration": {
      "Status": "Registered",
      "Message": "Project registered in parent solution.",
      "Solution": "/workspace/my-flow-projectSolution/my-flow-projectSolution.uipx",
      "Project": "my-flow-project/project.uiproj",
      "ProjectId": "00000000-0000-0000-0000-000000000000",
      "Instructions": "The project is listed in the parent solution manifest.
Packing or uploading the solution will sync solution resources automatically."
    },
    "AutoCreatedSolution": {
      "Name": "my-flow-projectSolution",
      "Path": "/workspace/my-flow-projectSolution",
      "SolutionFile": "/workspace/my-flow-projectSolution/my-flow-projectSolution.uipx"
    },
    "ProjectArtifacts": { "Created": true },
    "NextSteps": "The project is listed in the parent solution manifest.
Packing or uploading the solution will sync solution resources automatically."
  }
}

AutoCreatedSolution is present only when a parent solution was scaffolded automatically (i.e. the command wasn't run inside an existing solution). SolutionRegistration is absent entirely when --skip-solution-registration is passed.

En cas d'échec, Code est absent et la réponse comporte Result: "Failure", Message et Instructions.

Voir également

• uip maestro flow pack — compresser le projet structuré
• uip maestro flow node — ajoutez des nœuds au fichier .flow de démarrage
• uip maestro flow registry — découvrir les types de nœuds à ajouter
• Vue d’ensemble du flux