verdaccio/website/translated_docs/it-IT/notifications.md

id	title
notifications	Notifiche

Notify was built primarily to use with Slack's Incoming webhooks, but will also deliver a simple payload to any endpoint. This is currently only active for the npm publish command.

Utilizzo

Un esempio con un hook HipChat, Stride e Google Hangouts Chat:

Verdaccio supporta qualsiasi API, sentiti libero di aggiungere ulteriori esempi.

Notifica singola

notify:
  method: POST
  headers: [{'Content-Type': 'application/json'}]
  endpoint: https://usagge.hipchat.com/v2/room/3729485/notification?auth_token=mySecretToken
  content: '{"color":"green","message":"New package published: * {{ name }}*","notify":true,"message_format":"text"}'

Notifica multipla

notify:
  'example-google-chat':
    method: POST
    headers: [{'Content-Type': 'application/json'}]
    endpoint: https://chat.googleapis.com/v1/spaces/AAAAB_TcJYs/messages?key=myKey&token=myToken
    content: '{"text":"New package published: `{{ name }}{{#each versions}} v{{version}}{{/each}}`"}'
  'example-hipchat':
     method: POST
     headers: [{'Content-Type': 'application/json'}]
     endpoint: https://usagge.hipchat.com/v2/room/3729485/notification?auth_token=mySecretToken
     content: '{"color":"green","message":"New package published: * {{ name }}*","notify":true,"message_format":"text"}'
  'example-stride':
     method: POST
     headers: [{'Content-Type': 'application/json'}, {'authorization': 'Bearer secretToken'}]
     endpoint: https://api.atlassian.com/site/{cloudId}/conversation/{conversationId}/message
     content: '{"body": {"version": 1,"type": "doc","content": [{"type": "paragraph","content": [{"type": "text","text": "New package published: * {{ name }}* Publisher name: * {{ publisher.name }}"}]}]}}'

Template

Usiamo Handlebars come template engine principale.

Esempi di formato

# itera tutte le versioni
{{ name }}{{#each versions}} v{{version}}{{/each}}

# pacchetto publisher e `dist-tag` pubblicati
{{ publisher.name }} has published {{ publishedPackage }}

Proprietà

Elenco delle proprietà accessibili tramite template

• Metadata
• Publisher (chi sta pubblicando)
• Pacchetto pubblicato (package@1.0.0)

Metadata

Pacchetto metadata al quale il template ha accesso

{
    "_id": "@test/pkg1",
    "name": "@test/pkg1",
    "description": "",
    "dist-tags": {
        "beta": "1.0.54"
    },
    "versions": {
        "1.0.54": {
            "name": "@test/pkg1",
            "version": "1.0.54",
            "description": "some description",
            "main": "index.js",
            "scripts": {
                "test": "echo \"Error: no test specified\" && exit 1"
            },
            "keywords": [],
            "author": {
                "name": "Author Name",
                "email": "author@domain.com"
            },
            "license": "MIT",
            "dependencies": {
                "webpack": "4.12.0"
            },
            "readmeFilename": "README.md",
            "_id": "@ test/pkg1@1.0.54",
            "_npmVersion": "6.1.0",
            "_nodeVersion": "9.9.0",
            "_npmUser": {},
            "dist": {
                "integrity": "sha512-JlXWpLtMUBAqvVZBvH7UVLhXkGE1ctmXbDjbH/l0zMuG7wVzQ7GshTYvD/b5C+G2vOL2oiIS1RtayA/kKkTwKw==",
                "shasum": "29c55c52c1e76e966e706165e5b9f22e32aa9f22",
                "tarball": "http://localhost:4873/@test/pkg1/-/@test/pkg1-1.0.54.tgz"
            }
        }
    },
    "readme": "# test",
    "_attachments": {
        "@test/pkg1-1.0.54.tgz": {
            "content_type": "application/octet-stream",
            "data": "H4sIAAAAAAAAE+y9Z5PjyJIgOJ ...",
            "length": 33112
        }
    },
    "time": {}
}

Publisher

You can get access to the package publisher information in the content of a webhook using the publisher object.

Vedi sotto il tipo di oggetto publisher:

{
  name: string,
  groups: string[],
  real_groups: string[]
}

Un esempio:

notify:
  method: POST
  headers: [{'Content-Type': 'application/json'}]
  endpoint: https://usagge.hipchat.com/v2/room/3729485/notification?auth_token=mySecretToken
  content: '{"color":"green","message":"New package published: * {{ name }}*. Publisher name: * {{ publisher.name }} *.","notify":true,"message_format":"text"}'

Nota: non è possibile ottenere le informazioni del publisher se il file package.json ha già la proprietà publisher.

Pacchetto pubblicato

Si può accedere al pacchetto che è stato pubblicato con la keyword {{publishedPackage}} come segue.

{{ publisher.name }} has published {{ publishedPackage }}

Configurazione

Proprietà	Tipo	Richiesto	Supporto	Impostazione predefinita	Descrizione
metodo	stringa	No	tutti		HTTP verb
packagePattern	stringa	No	tutti		Eseguire questa notifica solo se il nome del pacchetto coincide con l'espressione regolare
packagePatternFlags	stringa	No	tutti		Qualsiasi flag da utilizzare con l'espressione regolare
intestazioni	array/oggetto	Sì	tutti		Se questo endpoint richiede intestazioni specifiche, definirle qui come un array della key: oggetti di valore.
endpoint	stringa	Sì	tutti		definire l'URL dell'endpoint per questa chiamata
content	stringa	Sì	tutti		qualsiasi espressione Handlebar