Verifica la connessione ad Aras Innovator e restituisce database, utente e numero di ItemType. Da usare per primo se qualcosa non funziona.

Elenca gli ItemType disponibili in Aras. L'istanza ne ha centinaia, quindi filtra con 'search' (ricerca tollerante su nome ed etichetta) oppure con 'kind'. Usalo PRIMA di interrogare dati, per scoprire il nome esatto del tipo.

Restituisce lo schema completo di un ItemType: tutte le proprieta' con tipo di dato e obbligatorieta', piu' le relazioni che partono da esso. Da usare PRIMA di scrivere query o di creare elementi, cosi' non devi indovinare i nomi delle proprieta'.

Interroga elementi di un ItemType con sintassi OData. Se non sei sicuro dei nomi delle proprieta', chiama prima aras_describe_item_type.

Recupera un singolo elemento tramite il suo id Aras (GUID a 32 caratteri).

CONSULTA PRIMA DI TENTARE. Risponde a 'come si fa X su Aras da un client esterno' e 'perche' questo errore', attingendo a due fonti: il sapere verificato sul campo — cio' che funziona davvero da fuori, con il messaggio esatto che Aras restituisce — e l'istanza stessa, cioe' il catalogo UserMessage e i Method installati. NON usa la documentazione ufficiale Aras: quella descrive JavaScript di client e C# di server, cioe' proprio le vie che da un client esterno non funzionano, e seguirla porta con sicurezza su strade cieche. Chiamalo quando una chiamata fallisce in modo incomprensibile, o prima di tentare qualcosa di insolito.

LEGGE IL CONTENUTO di un file del vault, non solo i metadati. Scarica dalla media resource OData (File('')/$value) con ripiego sull'endpoint del vault. Restituisce il testo per i formati testuali, il testo estratto per i PDF che ne contengono, e l'immagine stessa per PNG/JPEG/GIF/WebP, cosi' che possa essere guardata. Per un PDF scansionato dice che servirebbe un OCR invece di restituire il vuoto. Usa aras_get_files per trovare l'id.

Restituisce le righe di una relazione a partire da un elemento sorgente, es. i documenti allegati a una Part ('Part Document') o le modifiche che la riguardano ('Part Changes'). Usa aras_describe_item_type per scoprire quali relazioni esistono.

Esplode la distinta base (BOM) di una Part in modo ricorsivo, restituendo l'albero dei componenti con quantita' e quantita' cumulate. E' il modo corretto di rispondere a domande tipo 'da cosa e' composto questo prodotto' o 'quanti pezzi di X servono in totale'.

Crea un nuovo elemento. Le proprieta' vengono validate contro lo schema reale prima dell'invio. Disabilitato se il server e' in sola lettura (ARAS_READONLY).

Aggiorna le proprieta' di un elemento esistente. Validato contro lo schema. ATTENZIONE: su un ItemType versionabile (Part, Document, CAD) Aras crea una NUOVA GENERAZIONE a ogni update — anche solo per correggere una descrizione. Verificalo con aras_get_revisions prima e dopo se lo storico revisioni ti interessa. Disabilitato se il server e' in sola lettura.

Ricerca trasversale su piu' ItemType contemporaneamente: cerca un termine nei campi testuali (codice, nome, descrizione, titolo) di Part, Document, CAD, ECR, ECN, fornitori. Da usare quando NON sai in che tipo si trovi cio' che cerchi — Aras non ha una ricerca globale.

Crea una riga di relazione fra due elementi (es. 'Part Document', 'Part BOM'). Supporta anche gli elementi DIPENDENTI, che in Aras non possono essere creati prima: passa dependentProperties invece di relatedId e l'elemento viene creato inline dentro la relazione. E' l'unico modo di collegare un Affected Item a una ECR/ECN. Disabilitato in sola lettura.

Where-used: risale la distinta e trova TUTTI gli assiemi che usano un componente, a qualunque livello. E' la domanda da fare prima di modificare o dismettere un pezzo ('se cambio questa vite, cosa impatto?'). E' l'inverso di aras_get_bom.

Tutta la documentazione di una Part: Document (disegni, specifiche, manuali) e modelli CAD in una sola chiamata. In Aras sono due relazioni distinte ma rispondono alla stessa domanda.

File fisici allegati a un Document o a un CAD, con nome, dimensione, MIME type e URL di download dal vault. NOTA: il caricamento di file NON e' possibile da un client esterno — Aras rifiuta la creazione di File senza contenuto vaultato ('File Item cannot be added'), e le vie documentate sono solo JavaScript di client o C# di server. I file vanno caricati dall'interfaccia Aras. ATTENZIONE: questo tool restituisce METADATI e un URL di download, non il contenuto: il server non scarica ne' legge il file. Per il contenuto serve seguire l'URL con un client autenticato.

Costruttori approvati (Approved Manufacturer List) per una Part: i Manufacturer Part omologati e il relativo costruttore. Serve per acquisti e per valutare second source.

Elementi realmente impattati da una modifica (ECR o ECN), risolvendo gli Affected Item. In Aras la relazione non punta alla Part ma a un oggetto intermedio, quindi una query diretta restituirebbe solo id opachi.

Membri di un'identita' Aras (reparto, gruppo, ruolo): utenti e sotto-gruppi. Usa aras_query_items su 'Identity' per trovare l'id del reparto.

Traccia di audit di un elemento: chi ha fatto cosa e quando, attraverso tutte le revisioni. Aras lega lo storico al config_id tramite un History Container, non all'id della singola generazione, quindi copre l'intera vita dell'oggetto.

Verifica se una Part era valida a una certa data, in base a effective_date e superseded_date. E' l'effettivita' basata sulle date, quella che Aras popola sempre. Per l'effettivita' configurabile per modello/unita' usa aras_get_effectivity_config.

Processo di workflow di un elemento (ECR, ECN, Part...) con tutte le attivita', il loro stato e a chi sono assegnate. E' il modo di rispondere a 'a che punto e' questa modifica' e 'chi la sta bloccando'. Aras istanzia il processo automaticamente alla creazione.

Attivita' in carico a un'identita' (utente o gruppo): l'equivalente dell'InBasket di Aras. Trova prima l'id dell'identita' con aras_query_items su 'Identity'.

Completa un'attivita' di workflow scegliendo una via di uscita (es. 'Approve', 'Reject'). Passa da AML EvaluateActivity. Usa aras_get_workflow per trovare attivita' e assegnazione. Disabilitato in sola lettura.

Storia completa delle revisioni di un elemento versionabile: tutte le generazioni con revisione, stato, chi la tiene bloccata e quale e' la corrente. In Aras le generazioni sono righe distinte con id diversi che condividono config_id, e una query normale restituisce solo quella corrente: qui le vedi tutte.

Crea una nuova generazione (revisione) di un elemento versionabile, eseguendo la sequenza lock -> version -> unlock richiesta da Aras. Disabilitato in sola lettura.

ANALIZZA cosa comporterebbe cancellare un elemento, SENZA cancellarlo: quante generazioni sparirebbero, se e' rilasciato, se e' bloccato, e in quali relazioni e' ancora referenziato. Da chiamare SEMPRE prima di cancellare. Distingue purge (una generazione) da delete (tutte).

Cancella un elemento. RICHIEDE conferma esplicita e il modo desiderato. purge elimina solo la generazione indicata, delete elimina TUTTE le generazioni. Chiama prima aras_plan_delete. Disabilitato in sola lettura.

Stato attuale di un elemento, stati verso cui l'utente corrente PUO' promuoverlo, e — se non puo' — quale ruolo gli manca. In Aras ogni transizione ha un ruolo richiesto: se non lo possiedi, getItemNextStates torna vuoto e promoteItem fallisce con un messaggio che sembra dire 'transizione inesistente' mentre e' un problema di autorizzazione.

Grafo completo di un ciclo di vita: tutti gli stati e tutte le transizioni con il ruolo richiesto da ciascuna. Serve per capire quali percorsi esistono e chi puo' percorrerli.

Rilascia un elemento portandolo allo stato target, percorrendo il grafo delle transizioni passo per passo. Con dryRun mostra il percorso e i ruoli richiesti senza eseguire nulla. NOTA: su un ItemType versionabile la promozione crea una nuova generazione, quindi l'id cambia.

Valori AMMESSI dalle proprieta' di tipo lista di un ItemType (es. make_buy, unit, drawing_size). Da chiamare PRIMA di creare: un valore fuori lista supera la validazione dello schema — il nome della proprieta' esiste — ma viene rifiutato o ignorato da Aras.

Crea una Part con validazione dello schema E dei valori di lista, opzionalmente agganciandola subito a un assieme padre in distinta.

Crea un Document (disegno, specifica, manuale) o un CAD e lo collega a una Part.

Aggiunge, aggiorna o rimuove una riga di distinta base fra due Part, per item_number.

Duplica una Part con le sue proprieta' di dominio e, se richiesto, la distinta di primo livello. Revisione, stato e dati di audit vengono rigenerati da Aras.

Aggiunge un componente commerciale (Manufacturer Part) e lo approva su una Part, creando il costruttore se non esiste. Copre in un passo Manufacturer, Manufacturer Part e Part AML.

Verifica se un assieme e' pronto per il rilascio: elenca i componenti della distinta non ancora rilasciati. Rilasciare un padre con figli in Preliminary e' l'errore piu' comune.

Crea una ECR o una ECN con i suoi elementi impattati. Il numero (ECR-100001...) lo genera Aras e non va fornito. Gli Affected Item sono creati inline dentro la relazione: e' l'unico modo che funziona.

Aggiunge un elemento fra quelli impattati da una ECR/ECN esistente.

Fa avanzare una ECR/ECN votando l'attivita' ATTIVA del suo workflow. Fra le attivita' del processo una sola e' Active: le Pending sono a valle e votarle non produce effetti. dryRun mostra quale verrebbe votata.

Crea un utente e lo iscrive ai gruppi indicati. In Aras servono tre passi: lo User, l'Identity alias che Aras genera da se', e le righe Member verso i gruppi. Creare un secondo Alias fallisce ('cannot be greater than 1'), quindi l'appartenenza passa da Member.

Crea un gruppo o ruolo (Identity), opzionalmente annidato in un gruppo padre. I ruoli servono anche per le transizioni di ciclo di vita, che richiedono un'identita'.

Aggiunge o rimuove un'identita' da un gruppo. E' il modo di concedere un ruolo — per esempio dare 'Aras PLM' a un utente perche' possa rilasciare le Part.

Quali identita' possono aggiungere, modificare o cancellare istanze di un ItemType, e se l'utente corrente ne fa parte. E' la risposta a 'perche' non riesco a creare questo': Aras restituisce i dinieghi di permesso come errore 500 generico, non come 403.

Identita' possedute dall'utente configurato, incluse quelle ereditate per appartenenza a gruppi. Serve a capire perche' una promozione o una scrittura viene rifiutata.

Cruscotti configurati in Aras, con i tipi di contenuto che ospitano. Su un'istanza standard ne esistono gia' diversi (Engineering Efficiency, Time To Manufacturing...).

Metriche e indicatori definiti in Aras (es. 'ECR Cycle Time', 'Cost vs. Goal', 'CAD Model Release Time'). Filtra per nome se ne cerchi una in particolare.

Query salvate del Query Builder. Sono interrogazioni preconfezionate che Aras usa internamente e che puoi riusare, es. 'PE_BomStructure' o 'Aras.Resolution.LatestReleased'.

Struttura di una query salvata: da quali ItemType parte e quali parametri accetta. Da chiamare prima di eseguirla.

Tenta di eseguire una query salvata del Query Builder. LIMITE NOTO: l'esecuzione non e' raggiungibile da un client esterno — nessuna action AML documentata la esegue. Il tool restituisce allora la STRUTTURA della query e indica con quali strumenti ottenere gli stessi dati (aras_query_items, aras_get_bom, aras_where_used).

Configurazione dell'effettivita': scope, variabili (Model, Unit, Date), modelli di prodotto definiti e quante espressioni sono impostate sulle righe di distinta.

Crea un modello di prodotto, usabile come valore della variabile Model dell'effettivita' (es. 'CP-40', 'CP-60').

Crea un nuovo ItemType con le sue proprieta'. ATTENZIONE: Aras documenta questa configurazione solo dall'interfaccia (Administration -> ItemTypes), perche' oltre alla riga servono default permission, TOC Access e identita' Can Add. Il tool tenta l'intera sequenza e riporta passo per passo cosa e' riuscito, verificando alla fine se l'ItemType accetta davvero istanze.

Aggiunge una proprieta' a un ItemType esistente.

Diritti concessi da un Permission alle varie identita': chi puo' leggere, modificare, cancellare e scoprire gli elementi che lo usano.

Concede o modifica i diritti di un'identita' su un Permission. Nota: senza 'scoprire' (can_discover) l'elemento non compare nemmeno nelle ricerche, quindi viene concesso automaticamente insieme alla lettura.

Sostituisce un componente con un altro in TUTTE le distinte che lo usano — obsolescenza, second source. dryRun (default) mostra prima quali assiemi verrebbero toccati.

Aggiorna in blocco tutti gli elementi che corrispondono a un filtro OData. dryRun (default) elenca cosa verrebbe toccato senza scrivere.

Sequenze di numerazione automatica configurate (ECR, ECN, Part...) con il prossimo valore che verrebbe assegnato.

Metodi server definiti in Aras, ricercabili per nome. Utili per capire quale logica personalizzata esiste, e invocabili con aras_aml_request.

Esporta elementi in AML, il formato nativo di scambio di Aras: utile per travasare configurazioni fra istanze o per conservare uno stato.

Report configurati in Aras, con gli ItemType a cui sono agganciati. Su un'istanza standard ce ne sono gia' diversi: BOM Costing Report, BOM Quantity Rollup Report, Approved Vendors Report.

Esegue un report e restituisce i DATI (la trasformazione XSL serve solo alla resa grafica nel client). Molti report sono parametrici: passa contestoId con l'id dell'elemento su cui eseguirlo.

Cerca nel catalogo dei messaggi di Aras (UserMessage) per capire un errore opaco. Contiene i template di TUTTI i messaggi del server con i segnaposto {0}: cercando parte del testo ricevuto si risale al codice e al significato.

Ricerche salvate dagli utenti, con i criteri che usano.

Delega un'attivita' di workflow a un'altra identita', invece di votarla. Usa aras_get_workflow per trovare attivita' e assegnazione.

Applica un pacchetto AML: l'inverso di aras_export_aml. dryRun (default) analizza il contenuto e segnala quante azioni distruttive contiene prima di eseguirlo.

Log di Aras da due sorgenti: i file del server su disco (Innovator, OAuth, Client) e l'ItemType SystemEventLog a database. Su un'installazione nuova possono essere entrambe vuote: il logging su file va abilitato nella configurazione del server.

Promuove un elemento a un nuovo stato del ciclo di vita (es. Part da Preliminary a Released). Passa da AML perche' OData non espone le transizioni. Disabilitato in sola lettura.

Via di fuga: esegue AML (Aras Markup Language) grezzo contro InnovatorServer.aspx. Da usare solo per cio' che OData non copre — logiche di query non esprimibili con $filter, metodi server, azioni speciali. Passa il frammento <Item .../>, l'envelope SOAP e' automatico. Le action che scrivono sono bloccate in sola lettura.