Esempi di query

Di seguito sono riportate query pronte all'uso per i casi d'uso più comuni delle API di Altium 365. Tutti gli esempi utilizzano l'endpoint del Workspace e richiedono un token di accesso valido.

Individuazione

Elenca i Workspace

Recupera l'elenco dei Workspace dell'utente, inclusi gli URL degli endpoint API.

query {
  desWorkspaceInfos { 
    name
    description
    url
    location {
      apiServiceUrl
      filesServiceUrl
    }
  }
}

Progetti

Elenca i progetti

query {
  desProjects(first: 10) {
    nodes {
      id
      name
      description
      projectType
      updatedAt
    }
  }
}

Ottieni i dettagli del progetto

Recupera un progetto specifico tramite ID, inclusi i dati di progettazione, l'ultima revisione e i collaboratori.

query GetProject($id: ID!) {
  desProjectById(id: $id) {
    id
    name
    description
    projectType
    createdAt
    updatedAt
    design {
      releases {
        totalCount
      }
      variants {
        name
      }
    }
    latestRevision {
      author
      createdAt
      message
      revisionId
    }
  }
}

Libreria

Ottieni una panoramica della libreria

Restituisce la libreria del Workspace con il numero di componenti, footprint e simboli.

query GetLibraryOverview{
  desLibrary {
    name
    description
    updatedAt
    components {
      nodes {
        id
        name
      }
    }
    footprints {
      totalCount
    }
    symbols {
      totalCount
    }
  }
}

Approvvigionamento

Elenca le BOM

Restituisce tutte le BOM gestite nel Workspace con lo stato di integrità e il numero di voci.

query {
  bomBoms(first: 5) {
    nodes {
      bomId
      name
      createdAt
      updatedAt
      items {
        totalCount
      }
      releases {
        totalCount
        nodes {
          name
          releasedAt
          releaseNotes
        }
      }
      issues {
        severity
        description
        howToFix
      }
    }
  }
}

Team del Workspace

Elenca i membri del Workspace

query ListWorkspaceUsers {
  desWorkspaceTeamByAuth {
    workspaceGroups {
      nodes {
        id
        name
      }
    }
    workspaceUsers {
      nodes {
        id
        displayName
        email
      }
    }
  }
}