NavigazioneMarittima:PowerAutomate Tips

Un Workflow in PowerAutomate è composto da una sequenza di Workflow Actions.

Actions

Chiamate workflow actions sono le azioni elementari di un flusso di lavoro custom di Power Automate.

Variabili

E' possibile definire variabili tipizzate (mediante "Initialize variable") da usare in un flusso PowerAutomate, nel seguente esempio si definisce una di tipo intero ottenuta dinamicamente da una funzione:

Si può usare anche una action per l'aggiornamento di una variabile ed allo scopo si usa l'action "Set variable"

Conditions

Funzioni di controllo del flusso per verificare azioni precedenti e conseguentemente direzionare l'esecuzione del flusso.

Segue esempio di una Condition che corrisponde ad un "IF" il valore da valutare è di tipo testo, nome di un file, che non deve essere racchiuso né da singoli e nè da doppi apici.

SharePoint

Get items

Top 100

Di default seleziona 100 records, si cambia:

• cliccando sui tre puntini a sx, quindi scegliere "Settings"
• nella sezione "Pagination" impostare la paginazione cliccando sul pulsante On
• impostare un nuovo limite, il massino è 5000(purtroppo è un parametro obbligatorio)

ORDER BY

E' possibile ordinare gli elementi della lista SharePoint prima di salvarli, nel task cliccare su "Show advanced options", nel campo "Order by" si può usare una sintassi simile a SQL, quindi si può usare il nome campo corrispondente all'omonimo campo della lista seguito da ASC o DESC, si possono usare più campi per un ordinamento composto basta usare il separatore della virgola. Ad Es.:

ID desc, DataCusom asc

Select

Dopo l'estrazione di una lista di dati questi potranno essere selezionati mediante il task SEELCT.
Nella sezione * From si indica l'oggetto della sorgente dati mentre Nella sezione * Map si definisce l'output dei dati dell'elaborazione di selezione. Quanto sarà nella colonna di dx della tabella * Map è ottenibile attraverso il fumetto d'aiuto, dopo la selezione dell'opportuno campo, passando sopra il mouse, si visualizzerà il comando\funzione integrale generato automaticamente al fine di selezionare il dato.

Esistenza file

Non esiste una Action specifica ma si trova un modo per raggiungere lo stesso risultato, più semplice nel caso il file da ricercare sia in una Libray, ad esempio cartella canonica dei documenti.

In Document Library

Il file da cercare può essere anche in una sottocartella il seguente sistema lo cercherà comunque.
La via è usare il connettore\azione "Get Files (properties only)". Vedere il segeunte Post: powerusers.microsoft.com

Alternative

Una alternativa è indicata al post stackoverflow.
Si può usare la Action "Get file metadata using path dal connettore di SharePoint. Quando il file viene trovato abbiamo un output (visibile in modalità Test), JSON, come segue:

In caso negativo ad es. l'output è:

{
    "statusCode": 404,
    "headers": {
        "Cache-Control": "max-age=0, private",
..etc
    },
    "body": {
        "status": 404,
        "message": "File not found\r\nclientRequestId: f9f9d976-a9ba-4df2-bf6a-203e6557b9bc\r\nserviceRequestId: f9f9d976-a9ba-4df2-bf6a-203e6557b9bc"
    }
}

Delete file

Per cancellare un file il cui fileName prima è stato inserito in una variabile:

Trattamento Campi strutturati

Considerando che i dati su cui si posson fare delle selezioni o elaborazioni sono di tipo JSON è possibile trattarli definendo delle espressioni che utilizzano una sintassi specifica.
Supponendo che il JSON relativo ai dati rappresentati nel "value" del * From sia come segue

[
   {
      "ID":212,
      "Title":"Dashboard, July 2019",
      "Description":"Dashboard version issued on July 2019, elaborated on the data of June 2019. ",
      "Applicant Name":"Alberto Cravidi",
      "Mail address":"Alberto.Cravidi@vodafone.com",
      "Phone Number":"3488289394",
      "Creation Date":"2019-07-05",
      "Status":"Delivered",
      "Notes":"This request regards the generation of the monthly Dashboard",
      "Platform":[
         {
            "@odata.type":"#Microsoft.Azure.Connectors.SharePoint.SPListExpandedReference",
            "Id":0,
            "Value":"All"
         }
      ],
      "Provider":[
         {
            "@odata.type":"#Microsoft.Azure.Connectors.SharePoint.SPListExpandedReference",
            "Id":0,
            "Value":"Reply SpA"
         }
      ],
      "Delivery Date":"2019-07-10",
      "Complexity":"Low - No planning, no documentation",
      "Effort":1.0,
      "BaU Activities":"VCVI Dashboard",
      "InProgress Date":"2019-07-05",
      "ToOperation Date":null,
      "Rejected Date":null,
      "Closed Date":null,
      "CC&CV Resource Name":{
         "@odata.type":"#Microsoft.Azure.Connectors.SharePoint.SPListExpandedReference",
         "Id":-1,
         "Value":"Umberto GROPPELLI"
      },
      "Delivery Date by CC&CV":"2019-07-10",
      "Delivered Date":"2019-08-22",
      "Delivery Owner":"2 - VCVI",
      "Accepted Date":null,
      "VNO INProgress Date":null,
      "Item Type":"Item",
      "Path":"Lists/Infopath Custom List/"
   },
....etc....

Ad es. per acquisire il dato del campo "Platform" nella seconda colonna della tabella del task Select inserire:

item()?['Platform']?[0]?['Value']

Questo sarà il risultato:

mentre per il campo "CC&CV Resource Name" che non è ottenuto sotto un array scegliere come segue:

Formattazione

Date

Supponendo di trattare il seguente JSON con un campo data da trattare ovvero salvare su un ASCII CSV il campo data con una formattazione specifica.

{
"MiaData": "@formatDateTime(item()?['MiaData'],'dd-MMM-yy')"
}'

Supponiamo anche che questo campo data a volte potrà anche esser nullo, segue la formula che si può adottare per trasformare l'output secondo la formattazione desiderata (formula da inserire nella seconda colonna della action SELECT):

if (empty(item()?['MiaData']), '', formatDateTime(item()?['MiaData'],'dd-MMM-yy'))
// formatDateTime('2009-06-15T13:45:30', 'M/dd/yyyy h:mm tt')      Returns the format 6/15/2009 1:45 PM
// formatDateTime('2009-06-15T13:45:30', 'M/dd/yyyy HH:mm:ss tt')  Returns the format 6/15/2009 13:45:30 PM
// formatDateTime(utcNow(), 'dd-MM-yyyy')                          Returns the current date in the format 15-06-2009
// formatDateTime('2009-06-15T13:45:30', 's')                      Returns the format 2009-06-15T13:45:30

Notare l'uso delle istruzioni if(), empty(), formatDateTime().
Doc formatDateTime()

Triggers

Schedulazione

Si può far partire un flusso impostando un intervallo di esecuzione, nel seguente esempio si avvia un flusso alle 07:30 di ogni giorno:

Language

Il linguaggio "dovrebbe" essere Power Fx, MS overview.

Expressions

String Functions

Concatenazione di stringhe
Concat(text1,text2,...)
Es. concatenazione di due elementi di un vettore di stringhe separati da uno spazio vuoto (non importa se gli elementi del vettore sono nulli, non scatta errore)

Concat(item()?['Platform']?[0]?['Value'], ' ', item()?['Platform']?[1]?['Value'])

Es. concatenazione di due elementi di un vettore di stringhe separati da VIRGOLA ma solo se il secondo elemento esiste e non è nullo

Concat(item()?['Platform']?[0]?['Value']
	, if (empty(item()?['Platform']?[1]?['Value'])
		, ''
		, Concat(',', item()?['Platform']?[1]?['Value'])
		)
	)

Verifica se NULL o vuoto
empty(variabile)
, restituisce VERO se la variabile parametro è vuota

Controlli del flusso

If(condizione da verificare,variabile_caso_vero,variabile_caso_falso)
es.

If(variabile=1, 'Vero', 'Falso')

Mappa e Link

---

Power Automate | MS Power apps

---

Dizionario | JSON | JavaScript | SharePoint

---

Parole chiave: