grafcet.io

Formato de arquivo .grafcetio

Documentação técnica

O formato .grafcetio é um formato de arquivo baseado em JSON para armazenar e trocar diagramas GRAFCET. Esta documentação descreve a estrutura e todos os elementos disponíveis.

1. Estrutura do arquivo

Um arquivo .grafcetio é um arquivo JSON com a seguinte estrutura básica:

{
  "version": "1.0",
  "createdWith": "grafcet.io",
  "createdAt": "2024-01-15T10:30:00.000Z",
  "nodes": [...],
  "edges": [...],
  "counter": 5
}
  • versionNúmero da versão do formato (atualmente sempre "1.0")
  • createdWithNome do aplicativo que criou o arquivo
  • createdAtTimestamp de criação no formato ISO 8601
  • nodesArray com todos os símbolos GRAFCET (etapas, transições, ações, etc.)
  • edgesArray com todas as linhas de ligação (conexões entre símbolos)
  • counterContador interno para atribuição de IDs únicos

2. Símbolos GRAFCET

Todos os símbolos são armazenados no array "nodes". Cada símbolo tem a seguinte estrutura básica:

{
  "id": "step-1",
  "type": "step",
  "position": { "x": 400, "y": 240 },
  "data": { "label": "1" }
}
  • idIdentificador único do símbolo (ex: "step-1", "transition-2")
  • typeTipo de símbolo (veja tipos abaixo)
  • positionPosição no canvas em pixels (coordenadas x/y)
  • dataDados específicos do símbolo como rótulo, qualificador, etc.

Tipos de símbolos disponíveis

stepEtapa

Representa um estado no diagrama. Exibida como um retângulo com número da etapa.

Armazena: Número da etapa (ex: "1", "2", "10")

initialStepEtapa inicial

O estado inicial do GRAFCET, ativado automaticamente na inicialização. Exibida como um retângulo com borda dupla.

Armazena: Número da etapa (tipicamente "0")

transitionTransição

Define a condição de transição entre etapas. Exibida como uma linha horizontal com texto da condição.

Armazena: Condição de transição (ex: "a", "a AND b", "!x", "*" para sempre verdadeiro)

actionAção

Descreve uma saída ou ação executada quando a etapa está ativa. Posicionada à direita da etapa associada.

Armazena: Nome da ação, qualificador (N/S/R/D/L/P/C), valor de tempo para D/L, condição adicional para C

andNodeDivergência simultânea

Permite sequências paralelas no GRAFCET. Exibida como uma linha horizontal dupla.

Armazena: Largura (padrão: 240px), rótulo opcional

loopNodeCiclo

Símbolo de retroalimentação no GRAFCET. Exibido como uma linha vertical com uma seta triangular para cima. Dois símbolos com o mesmo marcador de referência substituem uma longa linha de retroalimentação.

Armazena: Marcador de referência (ex: "*", "A")

textAnotação de texto

Campo de texto livre para comentários e anotações. Não faz parte da lógica GRAFCET.

Armazena: Texto a exibir

Ação:

{
  "id": "action-1",
  "type": "action",
  "position": { "x": 500, "y": 230 },
  "data": {
    "label": "Motor ein",
    "qualifier": "N"
  }
}
{
  "id": "action-2",
  "type": "action",
  "position": { "x": 500, "y": 350 },
  "data": {
    "label": "Ventil öffnen",
    "qualifier": "D",
    "time": "5s",
    "condition": "p1"
  }
}

3. Qualificadores de ação (IEC 60848)

As ações podem ter qualificadores que determinam seu comportamento:

CódigoNomeDescrição
NContínuoA ação está ativa enquanto a etapa associada está ativa
SArmazenado (Set)A ação é ativada e permanece ativa após a desativação da etapa
RArmazenado (Reset)A ação é desativada (redefine uma ação previamente ativada)
DAtrasadoA ação começa apenas após o tempo especificado (requer valor de tempo)
LLimitadoA ação termina automaticamente após o tempo especificado (requer valor de tempo)
PPulsoPulso curto único quando a etapa é ativada
CCondicionalA ação só é executada se a condição adicional for atendida

4. Linhas de ligação

As linhas de ligação conectam os símbolos GRAFCET e definem o fluxo. São armazenadas no array "edges".

{
  "id": "e-step-1-transition-1",
  "source": "step-1",
  "sourceHandle": "bottom",
  "target": "transition-1",
  "targetHandle": "top",
  "type": "defaultEdge"
}
  • idIdentificador único da conexão
  • sourceID do símbolo de origem (onde a linha começa)
  • targetID do símbolo de destino (onde a linha termina)
  • sourceHandlePonto de conexão no símbolo de origem
  • targetHandlePonto de conexão no símbolo de destino
  • typeTipo de linha de ligação

Tipos de linhas

defaultEdge
Linha padrão – Conecta etapas com transições e transições com etapas. Também para conexões a divergências simultâneas.
actionEdge
Linha de ação – Conexão horizontal entre uma etapa e sua ação associada.

Pontos de conexão

Cada símbolo tem pontos de conexão definidos para as linhas:

  • "top" - Entrada de cima
  • "bottom" - Saída para baixo
  • "left" - Entrada da esquerda (para ações)
  • "right" - Saída para a direita (para linhas de ação)
  • Para divergências: "handle-0", "handle-1", ... (acima) e "source-0", "source-1", ... (abaixo)

Experimente o editor

Crie seu próprio diagrama GRAFCET e exporte-o como arquivo .grafcetio!

Ir para o editor

O que é o grafcet.io?

Editor online gratuito para criação de GRAFCET em conformidade com a norma IEC 60848.

r/grafcetio — Junte-se à nossa comunidade no Reddit

Esta plataforma é um serviço independente e não tem qualquer afiliação com organismos de normalização oficiais, organizações de exames ou instituições governamentais.

© 2026 grafcet.io

Formato de arquivo .grafcetio | Documentação