rer.ufficiostampa 1.0.1

Progressivo Comunicato Stampa

I comunicati stampa hanno un progressivo rispetto all’anno corrente (es: 1/2021).

Ogni volta che viene pubblicato un Comunicato Stampa, viene incrementato il progressivo e il valore viene associato a quel comunicato (scritto in un campo).

Il primo Comunicato Stampa inviato in un anno, parte col numero 1.

Aggiunta iscritto

• Metodo add

• Parametri: data (dizionario con i parametri)

• Risposta: l’id univoco del nuovo record

data deve essere un dizionario con la lista di possibili parametri:

• email [obbligatorio]: indirizzo a cui inviare i comunicati

• channels [obbligatorio]: lista dei canali di invio di interesse

• name: nome dell’iscritto

• surname: cognome dell’iscritto

• phone: numero di telefono dell’iscritto

• newspaper: nome della testata giornalistica di riferimento dell’iscritto

Altri campi verranno ignorati.

Ricerca iscritti

• Metodo search

• Parametri: query (dizionario con i parametri), sort_index (default=date), reverse (default=False)

• Risposta: la lista di risultati

query è un dizionario che può contenere uno o più dei seguenti parametri:

• text (viene ricercato nei campi nome, email e cognome)

• channels

• newspaper

Aggiornamento dati iscritto

• Metodo update

• Parametri: data (dizionario con i parametri), id (identificativo dell’iscritto)

• Risposta:

data è un dizionario che può contenere uno o più dei parametri di iscrizione.

Cancellazione iscritto

• Metodo delete

• Parametri: id (identificativo dell’iscritto)

• Risposta:

Reset database

• Metodo clear

• Parametri:

• Risposta:

Lista iscritti

@subscriptions

Endpoint da chiamare in GET sulla radice del sito.

Ritorna la lista degli iscritti e i possibili canali. Solo per gli utenti che hanno il permesso “rer.ufficiostampa.ManageChannels”:

> curl -i -X GET http://localhost:8080/Plone/@subscriptions -H 'Accept: application/json' -H 'Content-Type: application/json' --user admin:admin

La risposta è simile a questa:

{
    "@id": "http://localhost:8080/Plone/@subscriptions",
    "items": [
        ...
    ],
    "items_total": 42,
    "channels": [...]
}

Creazione nuovo iscritto

@subscriptions

Endpoint da chiamare in POST sulla radice del sito.

Solo per gli utenti che hanno il permesso “rer.ufficiostampa.ManageChannels”:

> curl -i -X POST http://localhost:8080/Plone/@subscriptions -H 'Accept: application/json' -H 'Content-Type: application/json' --data-raw '{"email": "foo@plone.org", "channels": ["first", "second"]}' --user admin:admin

Se l’operazione va a buon fine, il server ritorna un 204.

Aggiornamento dati iscritto

@subscriptions

Endpoint da chiamare in PATCH sulla radice del sito.

Solo per gli utenti che hanno il permesso “rer.ufficiostampa.ManageChannels”:

> curl -i -X PATCH http://localhost:8080/Plone/@subscriptions/subscription_id -H 'Accept: application/json' -H 'Content-Type: application/json' --data-raw '{"email": "foo@plone.org", "name": "John"}' --user admin:admin

Dove subscription_id è l’id dell’iscritto da aggiornare.

Se l’operazione va a buon fine, il server ritorna un 204.

Valgono le regole dei campi per la creazione.

Cancellazione iscritto

@subscriptions

Endpoint da chiamare in DELETE sulla radice del sito.

Solo per gli utenti che hanno il permesso “rer.ufficiostampa.ManageChannels”:

> curl -i -X DELETE http://localhost:8080/Plone/@subscriptions/subscription_id -H 'Accept: application/json' --user admin:admin

Dove subscription_id è l’id dell’iscritto da aggiornare.

Se l’operazione va a buon fine, il server ritorna un 204.

Cancellazione iscritto

@subscriptions-clear

Endpoint da chiamare in GET sulla radice del sito.

Solo per gli utenti che hanno il permesso “rer.ufficiostampa.ManageChannels”:

> curl -i -X DELETE http://localhost:8080/Plone/@subscriptions-clear -H 'Accept: application/json' --user admin:admin

Svuota completamente il db degli iscritti.

Se l’operazione va a buon fine, il server ritorna un 204.

Export in CSV

@subscriptions-csv

Endpoint da chiamare in GET sulla radice del sito.

Solo per gli utenti che hanno il permesso “rer.ufficiostampa.ManageChannels”:

> curl -i -X GET http://localhost:8080/Plone/@subscriptions-csv -H 'Accept: application/json' --user admin:admin

Ritorna un file csv con la lista degli iscritti.

Import da CSV

@subscriptions-csv

Endpoint da chiamare in POST sulla radice del sito.

Solo per gli utenti che hanno il permesso “rer.ufficiostampa.ManageChannels”:

> curl -i -X POST http://localhost:8080/Plone/@subscriptions-csv -H 'Accept: application/json' -H 'Content-Type: application/json' --data-raw '{"overwrite":true,"file":{"data": "...","encoding":"base64","content-type":"text/comma-separated-values","filename":"iscritti.csv"}}' --user admin:admin

Accetta i seguenti parametri:

• overwrite: se true, se esiste già un record nel db con l’email presente nel file, questo verrà sovrascritto con i nuovi dati. Se il parametro è mancante o false, viene mantenuto il valore già presente nel db senza aggiornarlo.

• clear: se true, prima di eseguire l’import, viene completamente cancellato il db.

• file: il file csv da caricare. Encodato in base64

La chiamata ritorna una risposta del genere:

{
    "imported": 0,
    "skipped": []
}

Dove imported è il numero di elementi inseriti effettivamente nel db, e skipped è la lista di righe del file che sono state ignorate per qualche motivo (entry già presenti e overwrite non impostato).

Contribute

• Issue Tracker: https://github.com/collective/rer.ufficiostampa/issues

• Source Code: https://github.com/collective/rer.ufficiostampa

• Documentation: https://docs.plone.org/foo/bar

Support

If you are having issues, please let us know. We have a mailing list located at: project@example.com

License

The project is licensed under the GPLv2.

1.0.1 (2021-07-09)

• Fix import for python2 and sort indexes. [cekk]

1.0.0 (2021-05-26)

• Initial release. [cekk]