No Apidog, uma organização é utilizada para gerir centralmente várias equipas e membros. Com organizações, pode controlar permissões, atribuir funções e garantir uma colaboração eficiente em toda a sua empresa.Criar uma Organização#
Pode criar uma ou mais organizações. Para criar uma nova organização:1.
Na janela principal, clique em Organizations no painel de navegação esquerdo para abrir a página de gestão da organização.
2.
Clique no botão + New Organization no canto inferior esquerdo.
3.
Introduza o nome da organização.
4.
Clique em Create. A sua nova organização está agora configurada.
Membros e Funções da Organização#
Pode convidar membros para a sua organização e atribuir-lhes diferentes funções:Org Admin: Tem as permissões mais elevadas (exceto o proprietário da organização). Pode gerir membros da organização, equipas e definições da organização.
Org Member: Pode aderir à organização e às respetivas equipas, e colaborar em projetos. Não pode alterar as definições da organização.
Convidar Membros para a Organização#
Como Proprietário ou Administrador da Organização, pode introduzir diretamente pessoal na empresa a partir do nível da organização. Isto é altamente adequado para departamentos de RH ou TI que distribuem centralmente contas para a integração de colaboradores.💡 Pré-requisito:
Antes de enviar um convite de organização, a sua organização deve ter pelo menos uma Equipa criada, caso contrário não haverá onde atribuir funções de equipa.
Para convidar membros para a organização, aceda a Members na sua organização:Clique em Invite, onde pode escolher um método de convite e conceder permissões em conformidade:1.
Convidar através de Link:
Função na Organização: Geralmente, os novos colaboradores recebem uniformemente a função Member.
Funções em Todas as Equipas: Ao convidá-los para a empresa, pode encaminhá-los diretamente para os pools de negócio subordinados correspondentes. Pode definir universalmente a mesma função para todas as equipas ou clicar em "Custom" para abrir os detalhes e especificar com precisão: "Entram apenas na Equipa A como Membro e permanecem sem aderir à Equipa B".
2.
Convidar por Email (ou Importação em Massa):
Além de suportar definições independentes para cada email e importação em massa por CSV, tal como ao nível da equipa, pode também utilizar a ferramenta de Configuração em Massa no topo para configurar rápida e uniformemente a Organization Role e as Team Roles especificamente atribuídas a este grupo de pessoas.
Cascata de permissões e Mapeamento de Funções Predefinidas#
É crucial compreender que as Funções da Organização e as Funções de Equipa/Projeto funcionam em dois percursos separados. Compreender como as permissões são propagadas — ou não são propagadas — é essencial ao atribuir funções:Funções da Organização vs. Acesso à Equipa: Os Administradores da Organização têm poder administrativo sobre a estrutura da empresa (por exemplo, criar equipas, gerir faturação e supervisionar o diretório de membros). No entanto, não obtêm automaticamente acesso aos dados de API dentro de projetos individuais. Para aceder ou editar um projeto, um Org Admin ainda tem de ser adicionado à Equipa ou ao Projeto relevante.
Administrador de Equipa → Editor de Projeto: Os utilizadores atribuídos como Administradores de Equipa recebem automaticamente permissões de Editor para todos os projetos dentro dessa equipa.
Membro de Equipa → Projeto Apenas de Leitura: Os utilizadores atribuídos como Membros de Equipa padrão recebem, por predefinição, acesso seguro Apenas de Leitura aos projetos da equipa.
Proibido / Não Aderiu: Se um utilizador não for atribuído a uma equipa (ou for definido como Proibido), não recebe qualquer acesso a projetos dentro dessa equipa.
Nota:
Estas são apenas as permissões de base iniciais. Uma vez dentro da equipa, os Administradores de Equipa podem ajustar individualmente as permissões de projeto ou personalizar funções com base nas necessidades reais do negócio.
Funções de Projeto Personalizadas#
As funções personalizadas suportam apenas o nível de Projeto. Atualmente, as funções da Organização não suportam personalização.
Relação Entre Organizações e Equipas#
Organização: A unidade de gestão de nível mais elevado, que representa uma empresa ou um grande grupo. Gere várias equipas.
Equipas: Uma subunidade dentro de uma organização, normalmente um departamento ou grupo mais pequeno. Gere vários projetos.
Organização vs. Equipa — Qual Deve Escolher?#
Ao utilizar o Apidog, uma pergunta comum é: deve gerir tudo diretamente sob uma Organização ou depender principalmente de Equipas? A resposta resume-se realmente a dois fatores — dimensão da equipa e âmbito do negócio.Se a Sua Equipa for Pequena e Focada#
Suponhamos que tem cerca de dez pessoas, todas a trabalhar na mesma linha de produto. Nesse caso, uma única Equipa é mais do que suficiente. Uma Equipa pode gerir projetos, APIs e membros num único local — de forma simples e eficiente, sem a sobrecarga adicional de uma Organização.Se a Sua Empresa for Grande e Distribuída#
Se tiver muitas pessoas e várias linhas de negócio não relacionadas, é melhor criar primeiro uma Organização e, em seguida, configurar Equipas separadas dentro dela para cada área de negócio. Cada Equipa gere os seus próprios projetos e membros, com limites claros e sem sobreposição.Os administradores podem atualizar o nome ou os detalhes da organização em Settings. Todos os membros verão as informações atualizadas.Transferir a Organização#
O proprietário da organização pode transferir a propriedade para outro membro através de Organization Settings → Danger Zone → Transfer.Dissolver a Organização#
O proprietário da organização pode eliminar permanentemente a organização em Organization Settings → Danger Zone → Dismiss Organization.Dissolver uma organização é permanente e não pode ser anulado. Todas as equipas e projetos dentro da organização serão eliminados.
